VSCode本身不运行代码，只是调用终端、code-runner、调试器或Python扩展等外部工具；所谓“无法运行”90%是某条执行链断裂，而非VSCode故障。
VSCode 本身不运行代码，它只是调用外部工具——终端、code-runner、调试器（launch.json）或 Python 扩展各自走各自的链路。所谓“无法运行”，90% 是某条链断了，而不是 VSCode 坏了。
终端里 command not found，但系统终端能用
这是最典型的环境分裂：VSCode 终端默认启动非登录 shell，不读 ~/.zshrc 或 ~/.bash_profile，PATH 就没加进去。
- 先验证：
echo $PATH对比系统终端输出，看是否缺/opt/homebrew/bin、~/.nvm/versions/node/v18.18.2/bin这类路径 - macOS/Linux 临时补救：
export PATH="$HOME/.nvm/versions/node/v18.18.2/bin:$PATH"（仅当前会话） - 长期修复：在
settings.json中设"terminal.integrated.shellArgs.osx": ["-l"]（macOS）或"terminal.integrated.shellArgs.linux": ["--login"]（Linux） - ⚠️ 注意：
-l会加载 profile，如果~/.zshrc里有阻塞操作（比如没加&的后台命令、read、或nvm初始化失败），终端可能卡死或闪退
Run Code 没反应或报 command 'code-runner.run' not found
这不是 VSCode 故障，是 code-runner 扩展根本没装、被禁用，或配置写错了。
- 打开扩展面板（
Ctrl+Shift+X），搜code-runner，确认已安装且状态为“启用” - 检查
code-runner.executorMap设置：比如 Python 对应值应为"python -u"，不是空字符串，也不是拼错的"pyhton -u" - Windows 用户若用 PowerShell，
code-runner可能被执行策略拦截，临时关防病毒软件测试一次 - 别依赖
python别名——macOS/Linux 往往只有python3；可直接配成"python3 -u"或绝对路径，如"/opt/homebrew/bin/python3 -u"
F5 调试报 Cannot find program 或 No configuration
F5 启动的是调试器，和终端、Run Code 完全无关，依赖 .vscode/launch.json 和对应语言的调试扩展。
- 首次按 F5 应弹出环境选择（Python/Node.js 等）。没弹？说明没装对应调试扩展，或文件后缀不匹配（比如
.py文件但没装 Python 扩展） -
launch.json中的program字段别写死绝对路径（如"program": "/home/user/script.py"），换成"${file}"更可靠 - Node.js 用户注意：
runtimeExecutable必须是真实可执行文件路径，如"/usr/local/bin/node"，不能只写"node"（调试器不继承 shell 的PATH） - Python 用户：右下角显示的解释器路径，必须和
launch.json中python.defaultInterpreterPath一致，否则断链
终端能跑，但 Run Code 或调试器报 ModuleNotFoundError
本质是环境不一致：你在终端手动激活了虚拟环境，但 code-runner 或调试器默认用的是系统 Python 或 VSCode 自选的解释器。
- VSCode 的 Python 扩展管理解释器，**不自动同步到集成终端**；终端始终走 shell 自身的
PATH查找逻辑 - 不要指望“Python: Select Interpreter”影响终端行为；想在终端用 venv，得手动运行
source .venv/bin/activate（macOS/Linux）或.venv\Scripts\Activate.ps1（Windows） - Windows 上若提示
Activate.ps1 cannot be loaded，执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser即可 - 想自动激活？可在设置中启用
python.terminal.executeInFileDir，再配合 shell 的cd和source逻辑（需自己写进~/.zshrc）
真正容易被忽略的点是：VSCode 的终端、Run Code、F5 调试三者完全独立，各自维护自己的环境、路径和配置。改了一个地方，其他两个未必跟着变。查问题前，先问清楚——你到底想用哪种方式执行？
