CodeRunner 运行 C 代码报 “command 'coderunner.run' not found” 是因插件未手动激活，需首次右键 Run Code 或按 Ctrl+Alt+N 触发；编译报错 gcc 路径问题源于系统 PATH 与 VSCode GUI 启动环境不一致，应确保终端中 which gcc 可用并用终端启动 VSCode；多文件项目需自定义 executorMap 调用 make 或显式列出源文件；中文乱码主因是 Windows 终端编码不匹配，推荐启用 runInTerminal 或添加 chcp 65001；CodeRunner 仅适合单文件快速验证，复杂项目应转向 tasks.json + launch.json。
CodeRunner 运行 C 代码时提示 “command 'coderunner.run' not found”
这是插件没启用或快捷键冲突的典型表现，不是配置缺失。VSCode 安装 CodeRunner 后默认不自动激活，需手动触发一次运行操作才能加载命令。
实操建议：
立即学习“C语言免费学习笔记（深入）”；
- 确保已安装
CodeRunner插件（作者：Jun Han），且状态为“已启用” - 打开一个
.c文件，右键选择Run Code，或按默认快捷键Ctrl+Alt+N（Windows/Linux）/Cmd+Option+N（macOS） - 若快捷键失效，检查是否被终端、输入法或远程桌面软件劫持；可临时改用右键菜单验证
- 首次运行后，
command 'coderunner.run' not found错误会消失，后续快捷键即可复用
CodeRunner 编译 C 时找不到 gcc 或报错 “The terminal shell path ‘/bin/bash’ does not exist”
CodeRunner 本身不自带编译器，它只是调用系统已安装的 gcc。路径错误本质是终端环境和 VSCode GUI 启动方式不一致导致的 PATH 不同步。
实操建议：
立即学习“C语言免费学习笔记（深入）”；
- 先在系统终端（非 VSCode 内置终端）中执行
which gcc，确认gcc可用且路径正确 - macOS 用户常见问题是 Shell 配置（如
~/.zshrc）里的PATH没被 VSCode GUI 进程读取；解决方法是用终端启动 VSCode：code . - Windows 用户若用 MinGW-w64，确保
mingw64\bin已加入系统环境变量PATH，重启 VSCode - 不要修改 CodeRunner 的
terminal.integrated.shell.*配置项——该设置在新版 VSCode 中已被弃用，改用terminal.integrated.defaultProfile.*
如何让 CodeRunner 自动编译并运行带 #include 的多文件 C 项目
CodeRunner 默认只处理当前打开的单个 .c 文件，对头文件或多个源文件无感知。它不是构建系统，不解析依赖或执行 Makefile。
实操建议：
立即学习“C语言免费学习笔记（深入）”；
- 简单场景（1–2 个
.c文件 + 头文件）：在 VSCode 设置中搜索coderunner.executorMap，找到c对应条目，把默认的gcc "$fileName" -o "$fileNameWithoutExt"改成显式列出所有源文件，例如：gcc "$fileName" utils.c -o "$fileNameWithoutExt" - 更稳妥的做法是用
code-runner.executorMap调用make：将值设为make -f Makefile "$fileNameWithoutExt"，再配好对应Makefile - 避免在
executorMap中写绝对路径或硬编码文件名，否则无法跨项目复用 - 如果只是临时测试，用 VSCode 内置终端手动敲
gcc main.c helper.c -o app && ./app反而更快，不必强求一键
CodeRunner 输出中文乱码（Windows 控制台显示 ）
根本原因是 Windows 终端默认使用 GBK 编码，而 VSCode 和 CodeRunner 默认以 UTF-8 传入源码和参数，终端解码失败。
实操建议：
立即学习“C语言免费学习笔记（深入）”；
- 最简方案：在 VSCode 设置中搜
code-runner.runInTerminal，勾选它，让 CodeRunner 使用 VSCode 内置终端（支持 UTF-8）而非系统 cmd - 若必须用外部终端，在
code-runner.executorMap的c条目开头加chcp 65001 &&，变成：chcp 65001 && gcc "$fileName" -o "$fileNameWithoutExt" && "$fileNameWithoutExt" - 注意
chcp命令仅对当前命令行生效，不能一劳永逸；且会影响执行速度，慎用于高频调试 - GCC 编译阶段一般不会乱码，乱码几乎都出现在运行时
printf输出环节，所以修复重点在运行环境，不在编译参数
tasks.json + launch.json 组合。很多人卡在“怎么让它完美跑大项目”上，其实它压根不是为那个设计的。 
