VSCode装了Python也不能直接点绿色三角形运行，必须安装官方Python扩展并手动指定解释器路径，否则会报错、无输出或模块找不到；解释器选择是工作区级的，需为每个项目单独配置。
VSCode 不是装了 Python 就能直接点绿色三角形跑代码的——它根本不知道该用哪个 python 可执行文件，也不会自动继承你终端里的环境。必须手动指定解释器路径，否则点按钮没反应、报 Command 'python' not found、ModuleNotFoundError 都是常态。
Python 扩展没装，右上角根本不会出现绿色三角形
VSCode 本身不识别 .py 文件，语法高亮、补全、调试按钮全靠扩展驱动。没有官方 Python 扩展（ID: ms-python.python），连 Ctrl+Space 都不会出提示。
- 打开扩展视图（
Ctrl+Shift+X），搜 “Python”，认准微软蓝标图标，点击安装 - 装完后重启 VSCode（尤其 macOS/Linux 用户，有时需手动重启才加载）
- 打开任意
.py文件，看左下角状态栏是否出现 Python 版本标识；没出现 = 扩展未生效
点绿色三角形没输出？八成是解释器没选对或路径不对
VSCode 默认不读系统 PATH，也不管你终端里 which python 输出什么。它只认你手动选的那个路径。
- 按
Ctrl+Shift+P输入Python: Select Interpreter，从列表选带完整路径的项，例如：./venv/bin/python（Linux/macOS 虚拟环境）、.\venv\Scripts\python.exe（Windows）、/usr/local/bin/python3.11 - 绝对别选 “Python 3.x (Global)” 这类模糊项——它可能指向系统自带的旧版 Python，而非你
pip install过包的那个 - 选完立刻看状态栏左下角：显示的必须是具体路径，不是“Python 3.11”几个字就完事
- 如果列表为空，选
Enter interpreter path，手动输（macOS 常见路径：/opt/homebrew/bin/python3；Windows：C:\Users\XXX\AppData\Local\Programs\Python\Python311\python.exe）
终端里能跑，F5 调试却报 ModuleNotFoundError？launch.json 配错了
F5 启动的是调试会话，和终端执行逻辑完全隔离。它不看你当前终端是否激活了虚拟环境，只认 launch.json 里写的 program 和 cwd。
立即学习“Python免费学习笔记（深入）”；
- 首次按 F5 会自动生成
.vscode/launch.json，模板选 “Python File” - 确认配置里是
"request": "launch"+"program": "${file}"，而不是"module": "xxx"—— 后者会触发python -m xxx，要求模块可导入，极易失败 - 如果脚本依赖相对路径（比如
from utils import helper），必须加"cwd": "${workspaceFolder}"，否则工作目录可能是用户主目录 -
"console": "integratedTerminal"比"internalConsole"更稳定，后者在新版中已弃用
中文乱码、subprocess 报 UnicodeEncodeError？关掉 terminal.integrated.env.*
VSCode 集成终端默认会注入一堆环境变量，其中某些（尤其是 Windows 上的 terminal.integrated.env.windows）会覆盖 Python 的编码行为，导致 subprocess.run(['python', '-c', 'print("你好")']) 输出问号或直接崩溃。
- 打开设置（
Ctrl+,），搜terminal.integrated.env - 把所有带
env的配置项（如terminal.integrated.env.linux、terminal.integrated.env.windows）全部清空或禁用 - 重启终端（
Ctrl+Shift+`关闭再开），再试 - 这个坑特别隐蔽：代码在外部终端正常，一进 VSCode 就崩，问题往往就在这儿
最常被忽略的一点：VSCode 的解释器选择是工作区级的，.vscode/settings.json 里写的 python.defaultInterpreterPath 只对当前文件夹生效。换个项目，得重新选——别指望一次设置全局通用。
