VSCode切换Python虚拟环境本质是切换解释器路径，但需分别刷新终端（重开或手动激活）、调试器（重启调试）和Jupyter内核（手动更换kernel），且必须以文件夹形式打开项目才能正确识别.venv。
VSCode 里切换 Python 虚拟环境，本质是切换解释器路径，但只点状态栏选一下远远不够——终端、调试器、Jupyter 内核各自认各自的解释器，不自动同步。
点状态栏 ≠ 切换完成
底部状态栏点击 Python 3.x.x 后选中一个 .venv 环境，只改了工作区的 python.defaultInterpreterPath，影响代码补全、Linting 和右键 Run Python File。但以下三处仍可能用错环境：
- 已打开的集成终端（
Ctrl+`）不会刷新PATH，which python还是旧路径 - 正在运行的 Debug 会话（
F5）继续跑在旧进程里，重启后才生效 - Jupyter Notebook 右上角 kernel 名字常滞后，需手动点 →
Change kernel→ 选带.venv或环境名的条目
列表里找不到你的 venv？手动路径最可靠
VSCode 不会自动扫描子目录下的 .venv，尤其当你从子文件夹打开项目、或 .venv 不在根目录时。常见症状：列表为空，或只有系统 Python。
- 先确认
.venv/bin/python（macOS/Linux）或.venvScriptspython.exe（Windows）真实存在且可执行 - 按
Ctrl+Shift+P→ 输入Python: Select Interpreter→ 底部选Enter interpreter path… - 别用相对路径（如
./.venv/bin/python），填绝对路径：/Users/you/project/.venv/bin/python或C:project.venvScriptspython.exe - 填完后 VSCode 会写入
.vscode/settings.json，字段是"python.defaultInterpreterPath"，不是已废弃的python.pythonPath
终端里 pip install 还是装到全局？激活没跟上
解释器切换和终端激活是两件事。你选了 .venv，但终端默认启动的是 shell 原始环境，pip install 自然走系统 PATH。
Claw Code Suite (Python-Only Edition)
下载
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
立即学习“Python免费学习笔记（深入）”；
- 临时解决：新开终端 → 手动运行
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，否则激活脚本可能因启动路径不对而失败
conda 环境特别容易出问题
VSCode 对 conda 的支持依赖 shell 初始化。如果 conda env list 在 VSCode 终端里报 command not found，解释器列表就不可能出现 conda 条目。
- 必须先在系统终端运行
conda init zsh（macOS/Linux）或conda init powershell（Windows），然后彻底关闭并重启 VSCode - 重启后，先在 VSCode 终端里验证
conda env list是否能列出环境，再执行Python: Select Interpreter - 若仍不行，跳过自动发现：直接
Enter interpreter path…，填 conda 环境里的真实python路径，例如~/miniconda3/envs/myenv/bin/python - 调试时务必检查
.vscode/launch.json，显式指定"python": "/path/to/conda/env/bin/python"，否则F5会 fallback 到 workspace 默认解释器
最容易被忽略的点：VSCode 只有在「以文件夹形式打开项目」（File > Open Folder）时，才会完整触发解释器发现逻辑；如果只是双击打开单个 .py 文件，Python: Select Interpreter 列表大概率为空，且无法写入 .vscode/settings.json。
