VSCode如何使用Code Runner一键运行各种语言单文件代码

先说个扎心的事实：指着一个按钮就想搞定一切？那可不行。Code Runner 的本质，说白了就是个“命令转发器”——你系统里得先有解释器或编译器，它才能帮你把命令递过去。这些命令是不是装好了、路径对不对、工作目录合不合理，全都得靠你自己来兜底。

很多朋友按下 Ctrl+Alt+N 后发现没反应，或者报“command not found”，问题根源就在这里。Code Runner 不会帮你装任何东西，它只是把 python、gcc、node 这些命令原样丢到 shell 里执行。所以，第一步永远是：在 VSCode 内置终端里手动敲一遍对应命令，确认它们能正常跑起来。

具体来看：

• Python 用户先试 python3 --version，千万别以为 python 这个命令还在（macOS 12.3+ 默认已经去掉了这个软链接）。
• C/C++ 用户必须装好 gcc 或 clang，并且 which gcc 能返回路径；Windows 下推荐 TDM-GCC，别把 WSL 的路径混进 VSCode。
• Ja va 必须装 JDK（不是 JRE），而且 ja vac 和 ja va 都得在 PATH 里——光配 ja va 是不够的。
• Go 用户注意：go run $fileName 要求当前目录有 go.mod，否则会报 no Go files in current directory。

改 code-runner.executorMap 让命令真正生效

默认配置只照顾最简场景，一碰到虚拟环境、多版本共存、中文路径或包依赖就崩了。改 settings.json 是绕不开的活儿，但别乱加引号或漏空格。

• Python 用虚拟环境？把 "python": "python -u" 改成绝对路径，比如 macOS/Linux 下写成 "python": "/Users/you/project/venv/bin/python -u"，Windows 下则是 "python": "C:\Users\you\project\venv\Scripts\python.exe -u"。
• Ja va 类名和文件名必须严格一致，且 public class 名要匹配；如果用了 package com.example;，就得把文件放在 com/example/Main.ja va 目录下，并在 executorMap 里加上 cd $dir/../.. && ja va com.example.Main。
• TypeScript 不是直接用 node 就能跑的，得先编译："typescript": "cd $dir && tsc $fileName && node $fileNameWithoutExt.js"，前提是全局装了 tsc（npm install -g typescript）。
• Rust 在 Windows 下，命令末尾要加 .exe："rust": "cd $dir && rustc $fileName && ./$fileNameWithoutExt.exe"，Linux/macOS 则不用。

中文输出乱码、input() 卡死、模块找不到，怎么办？

这些问题表面看是语言特性，根子都在 Code Runner 启动时的执行上下文被砍得太干净：没设工作目录、没传环境变量、没走真实终端。

• 中文乱码（尤其 Windows）：不是文件编码问题，是子进程终端用了 GBK。可以把 Python 命令改成 python -u -c "import sys; sys.stdout.reconfigure(encoding='utf-8'); exec(open('$fileName', encoding='utf-8').read())"。
• input() 卡住：Output 面板根本不提供 stdin。必须设 code-runner.runInTerminal: true，否则永远等不到输入。
• ModuleNotFoundError：Code Runner 默认在 $fileDirname 下执行，但你的 import utils 可能在项目根目录。设 code-runner.cwd: "$workspaceRoot"，或在 executorMap 里硬写 cd $workspaceRoot && python3 -u $fileName。
• 选中代码运行失败（比如只选 print(2+2)）：它会起临时脚本执行，不继承原文件变量作用域——别指望能用到上面定义的 arr 或 class。

哪些事 Code Runner 根本干不了，别硬扛

它的设计目标就是单文件快速验证，不是构建系统。一旦需求超出这个边界，强行改配置只会越改越糊。

• 运行整个项目（多文件、main.go + handler.go）：Code Runner 不解析依赖图，也不递归编译。该切 tasks.json + go run . 或 make。
• C++ 链接静态库或自定义头文件路径：默认 g++ 命令没 -I 和 -L，硬塞进 executorMap 容易路径错乱；更适合用 CMake Tools 插件。
• 需要前置格式化、lint、test 的流程：Code Runner 是单步执行，不支持 pipeline。这类任务请交给 tasks.json 或 launch.json。
• Shebang 文件（如 #!/usr/bin/env node）想自动识别？得开 code-runner.respectShebang: true，但某些旧版 macOS 的 /usr/bin/env 对路径太敏感，反而失败。

真正卡住人的，从来不是“怎么配”，而是搞不清 Code Runner 启动那一刻，它到底在哪个目录、用哪个解释器、以什么环境变量在跑——这些细节全藏在 code-runner.executorMap 里，少一个 $、多一个空格、路径里混了中文，输出就变成 /bin/sh: 1: python3: not found。