VSCode需手动配置Python环境：先安装并添加Python到PATH，再安装Python扩展、选择解释器、创建虚拟环境，最后配置launch.json调试文件，且须注意设置层级与路径有效性。
VSCode 本身不自带 Python 运行环境，必须手动配置解释器、扩展和工作区设置——否则 python 命令无法识别、调试器启动失败、语法高亮和补全全部失效。
安装 Python 解释器并验证命令行可用
VSCode 不会帮你装 Python，它只调用你系统里已有的 python 或 python3。Windows 用户常卡在这一步：装了 Anaconda 或官方安装包，但没勾选「Add Python to PATH」，导致终端里输入 python --version 报错「不是内部或外部命令」。
-
macOS 用户建议用
brew install python，默认路径清晰且版本可控 - Windows 用户安装时务必勾选「Add Python to PATH」，或手动把
Python\Scripts\和Python\加入系统环境变量 - 验证方式：打开 VSCode 内置终端（
Ctrl+`），运行which python（macOS/Linux）或where python（Windows），确保有输出
安装 Python 扩展并选择正确解释器
仅装 Microsoft 官方的 Python 扩展（ID：ms-python.python）还不够。扩展装完后，VSCode 并不会自动选中你刚装好的解释器，必须手动触发选择流程，否则所有功能（包括 Ctrl+Shift+P > Python: Select Interpreter）都无效。
- 按
Ctrl+Shift+P（Windows/macOS）或Cmd+Shift+P（macOS），输入Python: Select Interpreter - 如果列表为空，先点击右下角状态栏的
Select Python Environment，再点Enter interpreter path...，手动指向你的python.exe或python3可执行文件 - 选中后，VSCode 会在当前工作区生成
.vscode/settings.json，写入类似"python.defaultInterpreterPath": "./venv/bin/python"的配置
为项目创建并激活虚拟环境（推荐）
直接用系统 Python 容易引发包冲突，尤其是同时开发多个项目时。VSCode 支持自动识别 venv、virtualenv、poetry 等环境，但前提是它们得先存在——VSCode 不会替你创建。
立即学习“Python免费学习笔记（深入）”；
- 在项目根目录终端运行：
python -m venv venv（Windows）或python3 -m venv venv（macOS/Linux） - 然后再次执行
Python: Select Interpreter，VSCode 会自动扫描到./venv/bin/python（macOS/Linux）或./venv/Scripts/python.exe（Windows） - 确认选中后，终端左下角会显示
(venv)，且pip list输出应为空或仅含基础包
调试配置常见错误：launch.json 不生效
新建 Python 文件后点右上角 ▶️ 调试按钮，经常报错 No configuration found 或直接运行失败。这是因为 VSCode 默认不生成 .vscode/launch.json，必须通过调试面板显式初始化。
- 按
Ctrl+Shift+D打开调试面板 → 点「create a launch.json file」→ 选「Python File」 - 生成的配置中，
"module"模式适合运行python -m http.server类命令，"file"模式才对应当前打开的脚本 - 如果断点灰色不可用，检查是否选错了解释器，或当前文件未保存（VSCode 调试器只读取已保存的 .py 文件）
最常被忽略的是：VSCode 的 Python 设置是分层级的（用户级 / 工作区级 / 文件夹级），工作区级的 .vscode/settings.json 优先级最高，但很多人改了用户设置就以为全局生效了；还有人把 python.defaultInterpreterPath 写成相对路径却没注意当前工作目录，导致解释器路径解析失败。
