Code Runner在VSCode中无法运行代码时,需依次检查语言环境安装、修改settings.json中的executorMap配置、设置项目级.code-runner.json、禁用冲突扩展并授权磁盘访问权限。

如果您在VSCode中安装了Code Runner插件,但点击“运行”按钮后代码未执行或报错,可能是由于插件配置、解释器路径或语言支持设置不当。以下是解决此问题的步骤:
本文运行环境:MacBook Air,macOS Sequoia。
一、检查并安装对应语言的运行环境
Code Runner本身不包含任何语言的解释器或编译器,它依赖系统已安装的可执行程序(如python、gcc、node等)来运行代码。若目标语言未安装或不在系统PATH中,运行将失败。
1、打开终端,输入python3 --version确认Python是否可用;若提示命令未找到,则需安装Python。
2、对C/C++代码,运行gcc --version验证GCC是否就绪;若未安装,可通过Homebrew执行brew install gcc。
3、对JavaScript文件,执行node --version检查Node.js是否存在;缺失时前往官网下载安装包或使用brew install node。
二、配置Code Runner默认执行命令
Code Runner按语言类型调用预设命令,若系统中解释器名称与默认配置不一致(例如macOS上Python为python3而非python),需手动修改语言映射规则。
1、在VSCode中按下Cmd + Shift + P,输入并选择“Preferences: Open Settings (JSON)”。
2、在settings.json中添加或修改code-runner.executorMap字段,例如将Python条目改为:"python": "python3 -u",
3、对C语言,可设为:"c": "cd $dir && gcc $fileName -o $fileNameWithoutExt && ./$fileNameWithoutExt"。
三、启用当前文件夹的自定义运行配置
当项目需要特定编译参数或环境变量时,全局配置可能不适用,此时可在工作区根目录创建.code-runner.json文件实现覆盖。
1、在项目根目录新建文件,命名为.code-runner.json。
2、写入内容,例如为TypeScript配置tsc编译后再运行:{"executorMap": {"typescript": "cd $dir && tsc $fileName && node $fileNameWithoutExt.js"}}。
3、保存后重启VSCode,确保该配置被Code Runner识别并优先加载。
四、禁用冲突的扩展或调整运行权限
某些安全类扩展(如Shell Command Guard)或系统级权限限制(如macOS完全磁盘访问控制)可能导致Code Runner启动子进程失败。
1、进入VSCode扩展面板,临时禁用所有非必要扩展,仅保留Code Runner,测试是否恢复运行功能。
2、前往系统设置→隐私与安全性→完全磁盘访问,确认Visual Studio Code已在授权列表中。
3、若使用zsh作为默认shell,检查~/.zshrc中是否覆盖了PATH导致gcc或python路径失效,必要时在VSCode设置中指定shell路径:"code-runner.terminalRootPath": "/bin/zsh"。









