Code Runner扩展可实现VSCode中C/C++代码的一键编译与运行。需安装扩展、配置executorMap指定编译器及C17标准、启用保存自动运行与终端输出、设置快捷键cmd+enter,并解决中文路径及UTF-8编码问题。

如果您在VSCode中编写C/C++代码,但每次都需要手动调用编译器和运行命令,则可能是由于缺乏自动化执行工具。Code Runner扩展可通过一键操作完成编译与运行,显著减少终端输入负担。以下是配置与使用该扩展的具体方式:
本文运行环境:MacBook Air,macOS Sequoia。
一、安装Code Runner扩展
Code Runner是VSCode Marketplace中广为使用的轻量级执行工具,支持多种语言的快速运行,无需额外配置任务文件即可触发gcc或clang编译流程。
1、打开VSCode,点击左侧活动栏的扩展图标(四个方块组成的图标)。
2、在搜索框中输入Code Runner,找到由Jun Han发布的官方扩展。
3、点击“安装”按钮,等待安装完成并重启VSCode(如提示)。
二、配置默认C/C++执行命令
Code Runner默认使用系统PATH中的gcc或g++,但若本地编译器路径非标准或存在多版本,需显式指定编译器路径及参数,以确保正确调用。
1、按下Cmd+,(macOS)打开设置界面。
2、在右上角搜索框中输入code-runner.executorMap。
3、点击“在settings.json中编辑”,在对应语言键下添加或修改C与CPP条目,例如:
4、将"C": "cd $dir && gcc $fileName -o $fileNameWithoutExt && ./$fileNameWithoutExt"替换为包含-std=c17的完整命令。
三、启用保存后自动运行功能
该功能可在保存源文件时自动触发Code Runner执行,适用于频繁调试小段代码的场景,避免重复点击运行按钮。
1、进入VSCode设置界面,搜索code-runner.runInTerminal。
2、勾选该项,确保输出显示在集成终端而非弹出独立窗口。
3、继续搜索code-runner.saveFileBeforeRun,启用该选项。
4、再搜索code-runner.clearPreviousOutput,启用以避免旧输出干扰新结果。
四、使用快捷键替代鼠标操作
键盘操作可进一步提升效率,尤其在连续测试多个文件时,避免频繁切换鼠标与键盘。
1、按下Cmd+Shift+P打开命令面板。
2、输入Preferences: Open Keyboard Shortcuts (JSON)并回车。
3、在打开的keybindings.json中插入如下绑定:
4、将"key": "ctrl+alt+n"替换为cmd+enter,并确认"command": "code-runner.run"已存在。
五、处理中文路径与输出乱码问题
当源文件位于含中文字符的目录中,或程序输出含中文字符串时,Code Runner可能因编码识别错误导致编译失败或终端显示异常。
1、在用户设置中搜索code-runner.terminalRoot,将其值设为项目根目录的绝对路径(不含中文)。
2、在C文件开头添加预处理指令:#pragma GCC diagnostic ignored "-Wmultichar"。
3、修改终端编码:在VSCode集成终端中执行chcp 65001(Windows)或确保locale为UTF-8(macOS/Linux)。










