VSCode无法运行代码的根本原因是执行链断裂，需先明确使用Run Code、F5调试或终端命令哪种方式；常见问题包括未安装/禁用code-runner扩展、executorMap配置错误、Python路径未加入PATH、launch.json配置不当、解释器未正确选择虚拟环境等。
VSCode 本身不“运行”代码，它只是编辑器；所谓“无法运行”，实际是 code runner、Python 扩展、终端配置或调试器（launch.json）某处断链了。先确认你到底想用哪种方式执行——是右键“Run Code”，还是按 F5 启动调试，还是手动在集成终端里敲命令？方式不同，故障点完全不同。
点击“Run Code”没反应或报错“command 'code-runner.run' not found”
这是最典型的假性“VSCode 无法运行”：根本没装 code-runner 扩展，或装了但被禁用/损坏。
- 打开扩展面板（
Ctrl+Shift+X），搜code-runner，确认已安装且状态为“启用” - 检查是否设置了错误的执行命令：点击扩展设置齿轮 → “Extension Settings” → 搜索
code-runner.executorMap，展开后找到你当前语言（如python），确认值类似"python -u"而不是空字符串或拼错的pyhton - 如果用的是 Python，确保系统 PATH 里真有
python命令：在 VSCode 集成终端里执行which python（macOS/Linux）或where python（Windows），返回路径才有效 - 某些安全策略（如 macOS Gatekeeper 或 Windows Defender）会拦截
code-runner启动子进程，临时关闭防护软件测试一次
按 F5 启动调试直接失败，提示“Cannot find program”或“No configuration”
F5 触发的是调试器（Debugger），依赖 .vscode/launch.json 配置和对应语言的调试扩展（如 Python、JavaScript Debugger）。
- 首次按
F5时，VSCode 应自动弹出环境选择（如Python、Node.js）。没弹？说明没装对应调试扩展，或当前文件后缀不匹配（比如.py文件却没装Python扩展） - 已生成
launch.json但运行报错“Cannot find program”，检查其中program字段是否写死了绝对路径（如"program": "/home/user/script.py"），换成相对路径"${file}"更可靠 - Node.js 用户注意：
launch.json中若设了runtimeExecutable，值必须是真实存在的可执行文件路径，比如/usr/local/bin/node，不能只写node（某些系统 PATH 不被调试器继承）
终端里能跑，但 VSCode 的“Run Code”或调试器报“ModuleNotFoundError”
本质是环境不一致：终端用的是你手动激活的虚拟环境，而 code-runner 或调试器默认用系统 Python 或 VSCode 自己选的解释器。
- Python 用户：按
Ctrl+Shift+P→ 输入Python: Select Interpreter，从列表中选中你虚拟环境里的python（路径含venv或env） - 验证是否生效：在编辑器里新建空白
.py文件，输入import sys; print(sys.executable)，再用Run Code执行，输出路径应和上面选的一致 - 如果用了 Poetry 或 Conda，别只靠
Select Interpreter—— 还需在settings.json里显式指定："python.defaultInterpreterPath": "./.venv/bin/python"
（Linux/macOS）或"python.defaultInterpreterPath": ".\\venv\\Scripts\\python.exe"
（Windows）
真正卡住的地方往往不是 VSCode 本身，而是它和外部工具（Python/Node/Shell）之间的“握手”细节：路径对不对、权限够不够、环境变量承不继承、扩展有没有悄悄禁用。多看一眼终端输出的具体错误信息，比反复重装扩展有用得多。
