VS Code 的 Python 解释器配置必须显式指定路径，否则运行、调试、补全、linter 全部可能指向错误环境；无论安装多少版本，VS Code 都不会自动猜测，需通过 Python: Select Interpreter 手动选择或在 settings.json 中固化 python.defaultInterpreterPath 路径。
VS Code 的 Python 解释器配置必须显式指定路径，否则运行、调试、补全、linter 全部可能指向错误环境 —— 无论你装了多少个 Python 版本，VS Code 都不会自动猜。
Python: Select Interpreter 命令面板选不中解释器？
这是最常见卡点：命令面板里 Python: Select Interpreter 打开后列表为空，或只显示“Enter interpreter path…”。根本原因不是没装 Python，而是 VS Code 没扫描到可执行文件。
- 先确认终端能调用：
python --version或python3 --version能正常输出（比如Python 3.12.4），否则重装 Python 并勾选Add Python to PATH - Windows 用户注意：
where python和where python3可能返回不同路径，优先选带完整版本号的（如C:Users ameAppDataLocalProgramsPythonPython312python.exe） - macOS/Linux 用户注意：
which python3返回的是 shell 当前激活的解释器，但 VS Code 启动时不继承 shell 环境变量，所以即使终端能用，VS Code 仍可能找不到 - 如果列表为空，直接点击
Enter interpreter path…，粘贴which python3（macOS/Linux）或where python（Windows）结果，路径必须是绝对路径，不能用~或$HOME
settings.json 中 python.defaultInterpreterPath 怎么写才生效？
UI 上选一次只对当前工作区临时有效；写进 settings.json 才能固化。但路径格式和作用域极易出错。
- 工作区级配置（推荐）：在项目根目录下创建
.vscode/settings.json，写入：{ "python.defaultInterpreterPath": "./venv/bin/python" }（macOS/Linux）或{ "python.defaultInterpreterPath": ".\venv\Scripts\python.exe" }（Windows） - 用户级（全局）配置：按
Ctrl+,→ 右上角“打开设置(JSON)” → 添加同字段，但路径必须是**绝对路径**，例如："python.defaultInterpreterPath": "/usr/local/bin/python3.12"
或"python.defaultInterpreterPath": "C:\Python312\python.exe"
- ⚠️ 注意：
./venv/bin/python这类相对路径只在工作区级settings.json中有效；用户级配置中写相对路径会失败 - 保存后必须关闭并重新打开整个 VS Code 窗口（不是仅关标签页），右下角状态栏才会刷新显示新解释器
虚拟环境路径怎么让 VS Code 自动识别？
VS Code 不会自动激活虚拟环境，也不会自动把 .venv 目录当解释器源 —— 它只认解释器可执行文件本身。
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
立即学习“Python免费学习笔记（深入）”；
- 手动创建虚拟环境后（
python -m venv .venv），VS Code 通常会在状态栏弹提示“Select interpreter in .venv”，点它即可；若没弹，就手动用Python: Select Interpreter选.venv/bin/python（macOS/Linux）或.venvScriptspython.exe（Windows） - 想让多个项目统一用同个虚拟环境位置？可在工作区
settings.json加："python.venvPath": "${workspaceFolder}/.venv"，但这只是告诉 VS Code 去哪找，仍需配合python.defaultInterpreterPath显式指定解释器路径 - 不要依赖
source .venv/bin/activate后再打开 VS Code —— VS Code 启动时并不读取 shell 的激活状态，终端里which python返回的仍是虚拟环境路径，但编辑器内部仍可能用错解释器
为什么改了 settings.json 还是 import 报错？
常见现象：明明 python.defaultInterpreterPath 写对了，import requests 却报 ModuleNotFoundError。问题不在路径，而在环境隔离。
- 确认你安装包的 pip 是对应解释器的：
/path/to/your/python -m pip install requests，而不是全局pip install - VS Code 终端默认复用系统 shell，启动时未激活虚拟环境 → 即使编辑器用了
.venv解释器，终端里pip仍可能装到系统 site-packages - 解决办法：在 VS Code 终端里手动运行
source .venv/bin/activate（macOS/Linux）或.venvScriptsctivate（Windows），或在settings.json中加："terminal.integrated.env.linux": { "PATH": "/absolute/path/to/.venv/bin:${env:PATH}" }（其他平台同理） - 更稳妥的做法：所有包都通过 VS Code 的命令面板运行
Python: Install Package，它会自动调用当前解释器绑定的 pip
真正容易被忽略的不是怎么配，而是配完之后没验证终端、调试器、linter 是否全部同步指向同一个解释器 —— 它们各自读取配置的时机和方式不同，一个没对齐，就会出现“代码能跑但补全不生效”或“调试时 import 成功但终端里失败”这类撕裂感。
