每个子项目必须有独立的 .venv 并手动指定解释器路径，固化到各自 .vscode/settings.json 中；VS Code 仅扫描根目录及直接子目录，不递归识别嵌套环境，多子项目需单独打开工作区并提交配置以确保隔离与协作复现。
每个子项目必须有自己独立的 .venv（或统一命名的虚拟环境目录），VS Code 不会自动识别嵌套子目录里的环境，必须手动指定解释器路径并固化到各自子项目的 .vscode/settings.json 中。
子项目目录结构必须清晰，且虚拟环境不能跨级共享
VS Code 的 Python 扩展只扫描工作区根目录及其**直接子目录**下的疑似虚拟环境（如 .venv、venv、env），不会递归进 subproject/a/.venv 或 src/module/.venv 这类路径。如果你把多个子项目放在同一父文件夹下（比如 my-project/），但每个子项目是独立 Python 项目（如 my-project/backend/、my-project/frontend-api/），那就得按以下方式组织：
- 每个子项目目录（如
backend/）必须是 VS Code 的**单独打开的工作区**（即 File → Open Folder 选中backend/，而不是打开my-project/） - 每个子项目根目录下运行
python -m venv .venv创建环境，确保生成.venv/pyvenv.cfg和对应平台的python可执行文件 - 不要在父目录创建一个通用
.venv然后指望所有子项目共用——这等于没隔离，版本冲突风险照旧
“Python: Select Interpreter”必须在每个子项目工作区内单独执行
打开 backend/ 后，按 Ctrl+Shift+P 输入 Python: Select Interpreter，从列表里选 ./.venv/bin/python（macOS/Linux）或 ..venvScriptspython.exe（Windows）。VS Code 会自动写入该子项目的 .vscode/settings.json，内容类似：
{
"python.defaultInterpreterPath": "./.venv/bin/python",
"python.terminal.activateEnvironment": true
}
关键点：
立即学习“Python免费学习笔记（深入）”；
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
-
python.defaultInterpreterPath是唯一强制绑定解释器的字段，路径必须相对且准确；写成绝对路径或错误斜杠（如 Windows 用/）会导致后续调试器、终端、Pylance 全部失效 - 如果列表里没出现你的
.venv，说明它没被识别——检查.venv/pyvenv.cfg是否存在、python文件是否可执行（Linux/macOS）、或 PowerShell 执行策略是否阻止Activate.ps1（Windows） - 切勿依赖“全局设置”或“用户设置”来统一配置——它们对多子项目完全无效
终端不自动激活？补上 python.terminal.launchArgs 针对性配置
即使解释器选对了，集成终端默认仍运行在系统 shell 下，pip list 显示的还是全局包。要让终端一启动就进入对应子项目的虚拟环境，需在每个子项目的 .vscode/settings.json 中显式声明启动参数：
- Windows PowerShell：
"python.terminal.launchArgs": ["-ExecutionPolicy", "Bypass", "-File", ".venv\Scripts\Activate.ps1"] - macOS/Linux bash/zsh：
"python.terminal.launchArgs": ["-c", "source .venv/bin/activate && exec bash"] - 务必配合
"python.terminal.executeInFileDir": true，否则终端可能在错误路径下执行source导致失败
验证方式：打开终端后，提示符前应显示 (.venv)，且 which python（Linux/macOS）或 where python（Windows）返回的是子项目下的路径。
调试器和 LSP（如 Pylance）也依赖 settings.json 里的解释器路径
很多人只改了解释器，却忘了调试器（launch.json）和语言服务器（Pylance）同样读取 python.defaultInterpreterPath。如果子项目里有 .vscode/launch.json，其中的 python 字段可以留空，它会自动继承 settings.json 的配置；但如果写了硬编码路径（如 "python": "/usr/bin/python3"），就会覆盖设置，导致断点不生效、类型提示错乱。
- 删除
launch.json中多余的python字段，让其完全依赖settings.json - Pylance 的类型推导、自动补全全部基于当前解释器的
site-packages，若解释器路径错，import numpy就永远红波浪线 - 子项目之间切换时，务必关闭当前窗口再重新 Open Folder，不要靠“重新加载窗口”——后者不会重置解释器绑定状态
最常被忽略的一点：子项目一旦配置完成，.vscode/settings.json 必须提交进 Git。这不是个人偏好，而是团队协作前提——否则别人 clone 下来，VS Code 会回退到全局解释器，所有隔离努力归零。
