必须为每个项目单独设置解释器路径,否则 vs code 会复用上一个项目的缓存路径,导致 modulenotfounderror 或版本错乱;状态栏点击仅修改 python.defaultinterpreterpath,而终端、调试器、jupyter kernel 各自独立维护上下文,不自动同步已打开的进程。

必须为每个项目单独设置解释器路径,否则 VS Code 会复用上一个项目的缓存路径,导致 ModuleNotFoundError 或版本错乱。
为什么点状态栏选完还是跑错环境?
状态栏点击只改 python.defaultInterpreterPath,但终端、调试器、Jupyter kernel 各自维护上下文,不自动同步:
- 已打开的集成终端(
Ctrl+`)仍用旧PATH,which python不变 - 正在运行的调试会话(
F5)不会重启,继续用旧进程 - Jupyter Notebook 右上角 kernel 名字常滞后,需手动点 →
Change kernel→ 选带.venv或环境名的条目
列表里找不到你的 .venv 怎么办?
VS Code 默认只扫描项目根目录下的 .venv、venv、env,不递归子目录。常见于从子文件夹打开项目,或虚拟环境放在别处:
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能,主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ,专为学生、算法学习者和开发者设计;✅ 一个技能,两种用途 :;核心要点📝 题解模式 :输入题目/题号,自动生成完整 Python 题解(含详细注释、解题思路、复杂度分析);💬 注释模式 :输入 Python 代码,自动添加详细中。它将相关步骤、
- 先确认
.venv/bin/python(macOS/Linux)或.venvScriptspython.exe(Windows)真实存在且可执行 - 按
Ctrl+Shift+P→ 输入Python: Select Interpreter→ 选Enter interpreter path… - 填绝对路径:
/Users/you/project/.venv/bin/python或C:project.venvScriptspython.exe(别用./.venv这类相对路径) - 填完后 VS Code 会写入
.vscode/settings.json,字段是"python.defaultInterpreterPath"
终端里 pip install 还是装到全局?
解释器切换 ≠ 终端自动激活虚拟环境。你选了 .venv,但终端默认启动的是 shell 原始环境:
- 临时方案:新开终端 → 手动运行
source .venv/bin/activate(macOS/Linux)或.venvScriptsctivate.bat(Windows cmd) - 长期方案:在
.vscode/settings.json加配置,注意平台差异:
— macOS/Linux:"python.terminal.launchArgs": ["-c", "source .venv/bin/activate && exec bash"]
— Windows PowerShell:"python.terminal.launchArgs": [".venv\Scripts\Activate.ps1"],并提前运行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser - 关键前提:
"python.terminal.executeInFileDir": true,否则激活脚本因路径不对失败
最容易被忽略的是:.vscode/settings.json 里硬编码的路径一旦失效(比如重命名或删掉 .venv),VS Code 不报错也不提醒,而是悄悄 fallback 到系统 Python——得靠 which python 和 python -V 交叉验证才看得出来。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










