装对插件、选准解释器、用好工作区是VS Code运行Python的三大前提：必须只装ms-python.python插件，手动执行Python: Select Interpreter选择环境，且必须通过Open Folder打开项目文件夹而非单个.py文件。
装对插件、选准解释器、用好工作区，三步就能跑起来。其他配置全可延后，但跳过这三步，90% 的 ModuleNotFoundError 和断点不命中都由此而来。
必须只装 ms-python.python 这一个插件
微软官方 Python 插件 ID 是 ms-python.python，它自带调试器 debugpy、基础类型推断、测试集成和 Jupyter 支持。别装 Python Extension Pack 或 Python for VS Code —— 它们和官方插件冲突概率极高，会导致调试按钮灰色、断点失效、补全卡顿。
- 安装后务必按
Ctrl+Shift+P→ 输入Developer: Reload Window重载窗口 - 验证是否生效：打开任意
.py文件，状态栏左下角应显示类似Python 3.12.4 ('venv': .venv)的提示 - 如果没显示，先别调
settings.json，回头检查解释器是否已选
Python: Select Interpreter 必须手动执行
VS Code 不会自动识别你项目该用哪个 Python 解释器。尤其当你有 conda、pyenv、多个 venv 或系统 Python 并存时，靠默认行为几乎必然出错。
- 按
Ctrl+Shift+P→ 输入Python: Select Interpreter→ 从列表选实际环境路径 - 常见有效路径：
.venv\Scripts\python.exe（Windows）、.venv/bin/python（macOS/Linux）、~/miniconda3/envs/myenv/bin/python（conda） - 列表为空？点击
Enter interpreter path，在终端运行which python（macOS/Linux）或where python（Windows），粘贴输出路径 - 选完后，VS Code 会在项目根目录生成
.vscode/settings.json，记录所选解释器
工作区必须用“打开文件夹”，不能只开单个 .py 文件
只双击打开一个 hello.py，VS Code 就无法识别 .venv、pyproject.toml、ruff.toml 等项目级配置，Pylance 补全、Ruff 检查、甚至 import 路径解析都会失效。
立即学习“Python免费学习笔记（深入）”；
- 正确做法：新建空文件夹（如
myproject），在 VS Code 中选择File → Open Folder - 虚拟环境建议用
python -m venv .venv创建 —— 名称固定为.venv，VS Code 会自动识别并优先推荐 - 激活后终端应显示
(.venv)提示符；若没出现，检查是否在该文件夹下执行了激活命令，或重启 VS Code
最容易被忽略的其实是工作区上下文：哪怕插件装了、解释器也选了，只要没通过“打开文件夹”加载项目，所有路径敏感功能（包括 import 补全、linting、调试入口识别）都会降级或失效。这不是 bug，是设计逻辑 —— VS Code 的配置粒度是文件夹级，不是文件级。
