必须安装Microsoft官方Python扩展（ms-python.python），因其自带Pylance、debugpy及环境管理能力，是VS Code支持Python语法高亮、跳转定义、断点调试等功能的前提；第三方扩展功能残缺或已停更，且未选该扩展时“Python: Select Interpreter”命令不会出现。
只装一个扩展就够了：Microsoft 官方的 Python 扩展。 它自带 Pylance、debugpy 和环境管理能力，不是“可选”，而是 Python 在 VS Code 里能正常工作的前提。
为什么必须装 Python 扩展而不是其他名字相似的？
VS Code 本身不理解 Python 语法或运行逻辑。没装这个扩展时，print() 没高亮、Ctrl+Click 跳不到定义、断点打上去直接忽略——这些不是配置问题，是根本没语言服务。网上搜到的 “Python for VSCode”、“Better Python” 等第三方扩展，要么功能残缺，要么已停止维护。微软官方 Python 扩展（发布者是 Microsoft，ID 是 ms-python.python）是唯一被 debugpy、pytest、Jupyter 内核等底层工具深度集成的入口。
- 安装后自动附带
Pylance（类型推导和智能提示核心） - 自动启用
Python Debugger（基于debugpy） - 识别
venv、virtualenv、conda、pyenv环境，无需额外插件 - 不装它，
Python: Select Interpreter命令根本不会出现在命令面板里
Python: Select Interpreter 找不到或列表为空怎么办？
这是新手最常卡住的一步。不是插件没装好，而是 VS Code 还没扫描到你的 Python 可执行文件。
- 确认你本地确实装了 Python：终端运行
python --version或python3 --version有输出 - 如果用的是
pyenv或conda，先在终端激活对应环境，再从该终端启动 VS Code（code .），否则扩展会跳过未激活的环境 - 手动添加路径：运行
Python: Select Interpreter→ 点击“Enter interpreter path...” → 浏览到你 Python 的python.exe（Windows）或python3（macOS/Linux）文件 - 路径示例：
/usr/local/bin/python3、C:\Users\name\AppData\Local\Programs\Python\Python311\python.exe - 选完后状态栏左下角会显示解释器路径，且
.vscode/settings.json里自动生成"python.defaultInterpreterPath"配置
装完就写代码？别跳过这三处关键验证
扩展装完、解释器选好，不代表环境就 ready。必须现场验证三项基础能力：
立即学习“Python免费学习笔记（深入）”；
- 打开一个
.py文件，输入import os; os.—— 如果出现方法补全列表，说明Pylance工作正常 - 在
print("test")行左侧 gutter 点击加断点，按F5启动调试 —— 如果停在断点且能看变量，说明debugpy和解释器路径正确 - 右键菜单选“Run Python File in Terminal” —— 终端应执行并输出结果；若报错
ModuleNotFoundError，大概率是解释器选错了虚拟环境（比如选了系统 Python，但包装在 venv 里）
最容易被忽略的是解释器作用域：它默认只对当前工作区生效。如果你在文件夹 A 里选了 venv，然后直接用 VS Code 打开文件夹 B（没重新选解释器），B 会回退到系统默认 Python，导致包找不到、类型提示失效、甚至调试器启动失败。每次打开新项目，第一件事就是看状态栏左下角的 Python 版本是否符合预期。
