"""在 CPU / GPU 两套虚拟环境之间切换。 .venv CPU 环境 .venv-gpu GPU 环境 两套环境**同时存在**,切换只是「用哪个跑哪个」,不需要卸载重装。之所以不做成 一个环境来回切:paddlepaddle 与 paddlepaddle-gpu 互斥(都提供 `paddle` 顶层包和 同一批文件),而且 GPU 版还要带上约 3GB 的 CUDA 运行库,反复装卸很浪费。 用法: python scripts/switch_env.py --cpu # 建立/更新 CPU 环境 python scripts/switch_env.py --gpu # 建立/更新 GPU 环境(通道按显卡自动推荐) python scripts/switch_env.py --gpu --cuda cu126 # 指定 CUDA 通道 python scripts/switch_env.py --list # 只看两套环境的现状,不做改动 建好之后怎么用(入口脚本名固定是 ocr-server,由 pyproject.toml 的 [project.scripts] 决定,与 CPU/GPU 变体无关,变的只是所在的虚拟环境目录): 启动服务(CPU):.venv\\Scripts\\ocr-server.exe 启动服务(GPU):.venv-gpu\\Scripts\\ocr-server.exe 打 GPU 包(产出 dist\\ocr-server-gpu\\): $env:UV_PROJECT_ENVIRONMENT=".venv-gpu"; .\\scripts\\package-windows.ps1 """ import argparse import os import subprocess import sys from pathlib import Path PROJECT_ROOT = Path(__file__).resolve().parents[1] SCRIPTS_DIR = PROJECT_ROOT / "scripts" CPU_VENV = ".venv" GPU_VENV = ".venv-gpu" def venv_python(relative: str) -> Path: if os.name == "nt": return PROJECT_ROOT / relative / "Scripts" / "python.exe" return PROJECT_ROOT / relative / "bin" / "python" def run(command: list[str], env: dict[str, str] | None = None) -> int: print(f" $ {' '.join(command)}", flush=True) return subprocess.run(command, cwd=PROJECT_ROOT, env=env, check=False).returncode def sync_venv(relative: str) -> int: """把项目依赖同步进指定虚拟环境。 `--inexact` 不能省:paddle 不在 pyproject 的依赖里,普通 sync 会把手动装进去的 paddlepaddle / paddlepaddle-gpu 当成「多余包」删掉。 """ venv_path = (PROJECT_ROOT / relative).resolve() env = {**os.environ, "UV_PROJECT_ENVIRONMENT": str(venv_path)} print(f"[同步依赖] {relative}") return run(["uv", "sync", "--dev", "--inexact"], env=env) def describe(relative: str) -> str: python = venv_python(relative) if not python.is_file(): return "未创建" probe = ( "import importlib.metadata as md\n" "found = []\n" "for name in ('paddlepaddle', 'paddlepaddle-gpu'):\n" " try:\n" " found.append(f'{name}=={md.version(name)}')\n" " except md.PackageNotFoundError:\n" " pass\n" "if not found:\n" " print('未安装 paddle')\n" "else:\n" " import paddle\n" " cuda = paddle.device.is_compiled_with_cuda()\n" " count = paddle.device.cuda.device_count() if cuda else 0\n" " print(','.join(found) + f' | CUDA 可用:{cuda},GPU 数:{count}')\n" ) result = subprocess.run( [str(python), "-c", probe], capture_output=True, text=True, encoding="utf-8", cwd=PROJECT_ROOT, check=False, ) if result.returncode != 0: return "paddle 状态未知(导入失败)" return result.stdout.strip() def main() -> int: parser = argparse.ArgumentParser(description="在 CPU / GPU 两套虚拟环境之间切换") group = parser.add_mutually_exclusive_group() group.add_argument("--cpu", action="store_true", help=f"建立/更新 CPU 环境({CPU_VENV})") group.add_argument("--gpu", action="store_true", help=f"建立/更新 GPU 环境({GPU_VENV})") group.add_argument("--list", action="store_true", help="只查看现状") parser.add_argument("--cuda", choices=("cu118", "cu126", "cu129"), help="GPU 版的 CUDA 通道") parser.add_argument("--version", help="paddle 版本,默认 3.2.2") args = parser.parse_args() if args.list or not (args.cpu or args.gpu): if not args.list: parser.print_help() return 2 print(f"CPU 环境 {CPU_VENV:10} {describe(CPU_VENV)}") print(f"GPU 环境 {GPU_VENV:10} {describe(GPU_VENV)}") return 0 relative = CPU_VENV if args.cpu else GPU_VENV if args.cuda and args.cpu: print("--cuda 只在 --gpu 时有意义", file=sys.stderr) return 2 if sync_venv(relative) != 0: return 1 print(f"[安装 paddle] {relative}") command = [ sys.executable, str(SCRIPTS_DIR / "install_paddle.py"), "--python", str(venv_python(relative)), ] command.append("--cpu" if args.cpu else "--gpu") if args.cuda: command += ["--cuda", args.cuda] if args.version: command += ["--version", args.version] if run(command) != 0: return 1 # 入口脚本名固定是 ocr-server(见 pyproject.toml 的 [project.scripts]), # 和所在环境是 CPU 还是 GPU 无关。 executable = "Scripts\\ocr-server.exe" if os.name == "nt" else "bin/ocr-server" print(f"\n{relative} 就绪。") print(f" 启动:{relative}/{executable}") if args.cpu: print(' 打 CPU 包:直接运行 scripts/package-windows.ps1(产出 dist/ocr-server/)') else: print( " 打 GPU 包:设 UV_PROJECT_ENVIRONMENT=.venv-gpu 后运行 scripts/package-windows.ps1" "(产出 dist/ocr-server-gpu/)" ) return 0 if __name__ == "__main__": raise SystemExit(main())