VSCode中Python解释器未生效，主因是未显式绑定完整路径，必须通过“Python: Select Interpreter”选择带明确路径的条目（如./venv/bin/python），避免模糊名称；状态栏未更新需重启整个窗口；多版本共存时应重命名可执行文件并用相对路径配置，禁用python.defaultInterpreterPath全局设置。
Python解释器未生效，状态栏显示错误路径
VS Code 不自动继承终端激活的虚拟环境或系统 PATH，必须显式绑定解释器路径，否则 python 命令、调试器、补全、linter 全部可能指向不同环境。常见现象是：终端里 which python 返回 ./venv/bin/python，但 VS Code 状态栏却显示 /usr/bin/python3 或根本没反应。
- 按下
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入并选择Python: Select Interpreter - 优先点击带完整路径的条目（如
./venv/bin/python或.\venv\Scripts\python.exe），避免选“Python 3.x”这种模糊名称 - 若列表为空，点
Enter interpreter path…，粘贴终端执行which python（macOS/Linux）或where python（Windows）的结果 - 确认右下角状态栏更新；若没变，**必须关闭整个 VS Code 窗口再重开**（仅关标签页无效）
多个Python版本共存时调用混乱
直接安装多个 Python（如 3.11、3.14）却不做区分，会导致 python 命令始终指向 PATH 中第一个匹配项，项目间容易错用解释器。手动改名不是权宜之计，而是隔离前提。
- 在系统环境变量
Path（Windows）或$PATH（macOS/Linux）中，为每个版本单独添加两条路径：D:\Python314\和D:\Python314\Scripts\ - 进入安装目录（如
D:\Python314\），将python.exe复制一份并重命名为python3.14.exe；同理处理pip.exe→pip3.14.exe - VS Code 中选择解释器时，直接找
python3.14.exe路径，而非依赖模糊的“Python 3.14”文本描述 - 避免在
settings.json中写死python.defaultInterpreterPath为python或python3—— 这会绕过版本控制，实际调用不可控
虚拟环境创建后 VS Code 不识别 venv 目录
即使已运行 python -m venv venv，VS Code 仍不自动发现新环境，本质是它只扫描特定位置（如项目根目录下的 venv、.venv、env），且要求目录结构完整。
- 确保
venv文件夹位于当前打开的**工作区根目录下**（不是子文件夹内） - 检查
venv/bin/（macOS/Linux）或venv\Scripts\（Windows）中是否存在python（或python.exe）文件 —— 缺失说明创建失败，需重新执行python -m venv venv - 不要手动修改
venv内部文件结构，尤其不能删pyvenv.cfg，否则 VS Code 将拒绝识别 - 若使用 conda，VS Code 默认不扫描
conda envs目录，需手动指定路径，例如~/miniconda3/envs/myproject/bin/python
settings.json 中路径写法跨平台失效
在 settings.json 里写死解释器路径时，Windows 用反斜杠 \，macOS/Linux 用正斜杠 /，但 VS Code 的 python.defaultInterpreterPath 实际接受的是**相对于工作区根目录的路径**，且统一用正斜杠分隔 —— 即使在 Windows 上也应写 ./venv/Scripts/python.exe，而非 .\venv\Scripts\python.exe。
立即学习“Python免费学习笔记（深入）”；
- 正确写法（全部平台通用）：
"python.defaultInterpreterPath": "./venv/Scripts/python.exe"（Windows）或"python.defaultInterpreterPath": "./venv/bin/python"（macOS/Linux） - 绝对路径虽可工作，但破坏项目可移植性；相对路径 +
./开头才是团队协作前提 - 路径中不要包含空格或中文字符，否则某些插件（如 Pylance）会静默失败，不报错也不补全
- 该配置只对当前工作区生效；多项目需各自
.vscode/settings.json，不能靠全局设置统一管理
venv 目录一旦被 Git 忽略（.gitignore 里写了 venv/），VS Code 仍能识别它，但别误以为“看不见就等于不存在”。 
