VS Code运行Python需三步：显式指定解释器路径、启用Python扩展、工作区设为文件夹。未设解释器则调试/补全/导入失败；未装扩展则无语法高亮和智能提示；未用虚拟环境则包管理混乱；缺launch.json则F5调试失效。
VS Code 写 Python 不是装完就能跑，核心就三件事：解释器路径必须显式指定、Python 扩展必须启用、工作区得是文件夹而非单个文件。
Python 解释器路径没设对，所有功能都失效
VS Code 不继承终端的 PATH 或虚拟环境激活状态，不手动选解释器，print() 能运行但调试、补全、import 都可能报错。常见现象包括：
- 右下角状态栏不显示 Python 版本，或显示“Not found”
- F5 启动调试时提示 “No Python interpreter selected”
- 输入
import requests后标红，但终端里pip list明明有
解决方法只有两个可靠入口：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入并选择Python: Select Interpreter - 若列表为空，点
Enter interpreter path…，粘贴which python3（macOS/Linux）或where python（Windows）查到的绝对路径 - 选完后务必关闭整个 VS Code 窗口再重开——仅刷新标签页不生效
Python 扩展没装或没启用，代码就是纯文本
VS Code 本身不带 Python 支持，ms-python.python 扩展是所有智能功能的唯一来源。没它：
立即学习“Python免费学习笔记（深入）”；
- 没有语法高亮（.py 文件像 .txt）
-
Ctrl+Space补全不出任何函数或变量 - 跳转定义（
F12）、查看类型（Ctrl+Hover）全部失效
安装后必须重启 VS Code 才能激活。验证方式：打开命令面板，搜 Python:，能看到一长串命令（如 Python: Create Environment）即表示已就位。
用虚拟环境却没在工作区里选它，包管理全乱套
直接用全局 Python 安装包，项目迁移或协作时极易出问题。正确做法是每个项目配独立环境：
- 终端进项目根目录，执行
python -m venv .venv（Windows）或python3 -m venv .venv（macOS/Linux） - 运行
Python: Select Interpreter，从列表中选.venv/bin/python（macOS/Linux）或.venv\Scripts\python.exe（Windows） - 此时终端自动激活该环境（右下角会显示
.venv），pip install装的包只在这个项目里生效
别信“自动识别”——VS Code 不会主动扫描 .venv 文件夹，必须人工点选。
launch.json 不配，F5 就只是摆设
调试依赖 launch.json，不是按 F5 就能进断点。最简配置只需一步：
- 按
Ctrl+Shift+D进调试侧边栏 → 点“创建 launch.json 文件” → 选Python File - 生成的配置里确保
"program": "${file}"和"console": "integratedTerminal"存在 - 如果想让程序运行完不自动关终端，加一行
"stopOnEntry": false
漏掉这步，F5 会弹窗报错，而不是运行代码。
最容易被忽略的是：解释器路径一旦写死在 settings.json 里（比如 "python.defaultInterpreterPath": "./.venv/bin/python"），后续换项目必须手动删掉这行，否则新项目会强行复用旧环境的解释器——连 Python: Select Interpreter 都覆盖不了这个配置。
