CodeGeeX无法识别本地Python路径的根本原因是其进程未正确继承或定位系统Python环境。需先通过python -c "import sys; print(sys.executable)"确认实际解释器路径，再统一修复PATH继承、虚拟环境激活、config.yaml硬编码路径及进程重启等环节，确保torch、transformers等依赖被正确加载。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
CodeGeeX安装后无法识别本地Python路径，会导致模型加载失败、API服务启动报错（如ModuleNotFoundError: No module named 'torch'）、或VS Code插件提示“Python interpreter not found”，根本原因是CodeGeeX运行时依赖的Python环境未被其进程正确继承或定位。
确认CodeGeeX实际调用的Python解释器
CodeGeeX本身不自带Python，它完全依赖系统已安装的Python环境执行。先验证当前终端中CodeGeeX启动脚本实际使用的是哪个Python：
在命令行中进入CodeGeeX项目根目录，执行：python -c "import sys; print(sys.executable)"
这一步输出的路径就是CodeGeeX真正使用的解释器——不是你桌面快捷方式点开的Python，也不是VS Code里选的那个，而是终端当前shell环境下的python命令指向的可执行文件。
立即学习“Python免费学习笔记（深入）”；
【关键前提】必须在启动CodeGeeX前执行该命令，否则可能因虚拟环境激活状态不同而得到错误结果。
修复PATH未生效导致的解释器不可见
Windows下常见现象：你在CMD里能运行python --version，但双击app.py或用VS Code右键“Run Python File”却报错“找不到python”。这是因为图形界面启动的进程不继承CMD中已刷新的PATH。
方法一：从命令行启动CodeGeeX（推荐）
关闭所有图形界面窗口，打开新的CMD或PowerShell，cd到CodeGeeX目录，直接运行：python app.py
这确保了CodeGeeX进程与你验证过的Python环境完全一致。
方法二：为CodeGeeX创建专用快捷方式
右键桌面→新建→快捷方式，目标栏填入：cmd /k cd /d "C:path oCodeGeeX" && python app.py（把C:path oCodeGeeX替换成你的真实路径）
这样每次双击都等效于手动打开CMD并执行，绕过PATH继承失效问题。
解决虚拟环境未被CodeGeeX识别的问题
如果你用python -m venv codegeex_env创建了独立环境，CodeGeeX默认不会自动激活它——它只认python命令，不认activate.bat。
第一步：激活虚拟环境并确认解释器路径
在CodeGeeX目录下运行：codegeex_envScriptsctivate.bat → 然后执行：where python（Windows）或which python（macOS/Linux）
第二步：强制CodeGeeX使用该环境解释器
修改app.py开头的shebang或启动逻辑，将第一行改为：#!/path/to/codegeex_env/Scripts/python.exe（Windows）或#!/path/to/codegeex_env/bin/python（macOS/Linux）
第三步：验证依赖是否就位
在激活状态下运行：python -m pip list | findstr torch（Windows）或python -m pip list | grep torch（macOS/Linux），确保torch、transformers等关键包存在。
注意：不要在未激活环境下用pip install -r requirements.txt，否则包会装进系统Python而非虚拟环境。
检查config.yaml中硬编码路径是否匹配真实安装位置
CodeGeeX的config.yaml文件里可能包含python_path或interpreter字段，若填写了绝对路径，必须与你当前使用的Python解释器路径完全一致。
打开config.yaml，查找类似字段：
python_path: "C:UsersAliceAppDataLocalProgramsPythonPython310python.exe"
用之前python -c "import sys; print(sys.executable)"输出的路径覆盖此值。
【易错点】路径中含空格或中文时，Windows需用双引号包裹，且反斜杠要写成\或正斜杠/，例如："C:/Users/Alice/AppData/Local/Programs/Python/Python310/python.exe"。
重启终端与CodeGeeX进程
① 关闭所有正在运行的CodeGeeX相关进程（包括后台的app.py、uvicorn、pythonw.exe）
② 在任务管理器中结束所有python.exe实例（尤其留意隐藏在后台的）
③ 重新打开一个全新终端窗口（不要复用旧窗口）
④ 进入CodeGeeX目录，执行：python app.py
