VSCode选解释器时必须填虚拟环境内Python可执行文件的完整相对路径:Windows为./.venv/Scripts/python.exe,macOS/Linux为./.venv/bin/python;路径不能含空格或中文,且需写入工作区.vscode/settings.json中python.defaultInterpreterPath字段,改后须重启VSCode,并单独配置Jupyter kernel路径。

VSCode选解释器时该填什么路径?
VSCode只认虚拟环境里的python可执行文件本身,不是文件夹、不是activate脚本、也不是软链接或符号链接。路径必须是相对于工作区根目录的相对路径,且必须精确指向二进制文件:
- Windows:
./.venv/Scripts/python.exe(不是activate.bat,不是python软链接) - macOS/Linux:
./.venv/bin/python(不是activate,不是python3符号链接) - 如果用
venv而非.venv,对应路径为./venv/Scripts/python.exe或./venv/bin/python - 路径里不能含空格或中文,否则Pylance可能解析失败;建议统一用
.venv,Git和VSCode默认忽略它
为什么选对了路径,补全还是不准、报ModuleNotFoundError?
常见原因不是路径错,而是VSCode缓存或配置没同步生效:
-
python.defaultInterpreterPath必须写入当前工作区的.vscode/settings.json,而不是用户级设置——用户级设置会覆盖项目级配置 - Pylance类型信息有强缓存,改完解释器后必须重启VSCode,否则补全、跳转、类型提示仍基于旧环境
- 状态栏显示
Python 3.x ('.venv': venv)只是UI提示,不等于真实生效;验证唯一可靠方式是运行import sys; print(sys.executable),输出必须含.venv - 如果项目在WSL中创建但VSCode运行在Windows端,
./.venv/bin/python无法直接访问,需用\wsl$Ubuntuhomeuserproject.venvinpython这类wsl$前缀路径
终端里pip install还是装到全局?
选了解释器 ≠ 终端自动激活环境。VSCode集成终端默认不运行activate脚本,所以pip install默认仍走系统Python:
将测试、lint、构建和文档流程编码为命名的Python会话,以便人类和代理每次运行相同的workflow。
- 必须设
python.terminal.activateEnvironment为true(默认是true,但容易被用户级设置覆盖) - Windows PowerShell用户额外注意:
python.terminal.launchArgs若被设为["-NoExit", "-Command", ""],会清空激活逻辑,建议清空该项 - 验证方法:新开终端后,提示符前应出现
(.venv)前缀;若没有,说明没激活成功,此时which python或where python仍指向系统路径
Jupyter Notebook kernel要单独配
VSCode里编辑器解释器和Notebook kernel是两套独立配置,互不影响:
- 右上角kernel下拉菜单必须手动选匹配的
.venv环境,不能依赖编辑器解释器选择结果 - kernel列表里显示的
Python 3.x (venv)名称不可信,点击“Change kernel”后点“Existing”再选路径,确认最终路径指向.venv/bin/python或.venv/Scripts/python.exe - kernel启动失败常见原因是
ipykernel没装在目标venv里——得在激活该venv的终端里运行pip install ipykernel,再执行python -m ipykernel install --user --name myproj --display-name "Python (myproj)"
真正卡住人的地方,往往不是创建环境,而是路径写成绝对路径、没重启VSCode、或者kernel和编辑器解释器混为一谈。这些点不显眼,但一错就全链路失效。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










