Code Runner插件未安装或未启用会导致运行按钮灰色或报“command 'code-runner.run' not found”；Python路径配置错误会引发“python: command not found”；JavaScript在浏览器环境运行需改用Live Server；C/C++需确保编译器可用、main函数规范及正确链接库。
运行按钮灰色不可点，或点击后报“command 'code-runner.run' not found”
这是 Code Runner 插件未安装或未启用的典型表现。VSCode 默认不带代码执行功能，code-runner 是最常用的第三方运行插件，但必须手动安装并确认启用。
- 打开扩展面板（Ctrl+Shift+X 或 Cmd+Shift+X），搜索
code-runner，安装由Jun Han发布的官方版本 - 安装后重启 VSCode，或在命令面板（Ctrl+Shift+P）中输入
Developer: Reload Window重载窗口 - 检查是否被禁用：右键扩展列表中的
Code Runner→ 确保 “Enable Extension” 已勾选 - 若仍报
command 'code-runner.run' not found，说明插件加载失败，可尝试卸载后清空~/.vscode/extensions/junhan.code-runner-*文件夹再重装
Python 文件点运行却提示“python: command not found”或启动了错误解释器
Code Runner 默认调用系统 PATH 中的 python 命令，但 macOS / Linux 可能只有 python3，Windows 可能装了多个 Python 版本却没配好环境变量。
- 先在终端执行
which python（macOS/Linux）或where python（Windows），确认可用的 Python 可执行文件路径 - 在 VSCode 设置中搜索
code-runner.executorMap，点击“在 settings.json 中编辑”，添加或修改 Python 配置项：
"code-runner.executorMap": {
"python": "python3 -u $fullFileName"
}
- 如果使用虚拟环境（如
venv或conda），需指定完整路径，例如：/path/to/venv/bin/python -u $fullFileName - 注意不要写成
python -u $fileName——$fileName不含路径，跨目录运行时会报ModuleNotFoundError
运行 JavaScript 时提示“ReferenceError: require is not defined”或直接空白
Code Runner 默认用 node 执行 JS 文件，但如果你打开的是浏览器端脚本（含 require、document 等 API），或用了 ES Module 语法（import），就会失败。
- 确认脚本用途：纯 Node.js 脚本 → 保留
node执行；浏览器脚本 → 不该用 Code Runner 直接运行，应搭配 Live Server 插件开本地服务 - ESM 支持需显式加
--experimental-modules或改用.mjs后缀；更稳妥的做法是把"javascript"的 executorMap 改为：
"javascript": "node --experimental-modules -u $fullFileName"
- 若脚本依赖
npm包，确保已运行npm install，且node_modules在当前工作目录下（Code Runner 默认以文件所在目录为工作目录）
运行 C/C++ 报错“launch: program ‘xxx’ does not exist”或“undefined reference to main”
Code Runner 对编译型语言只做一键构建+运行，不处理头文件、链接库或项目结构，出错多因缺少编译器或源码不满足可执行程序要求。
- 先验证编译器可用：终端中运行
gcc --version或g++ --version，若提示未找到，需安装 MinGW（Windows）、Xcode Command Line Tools（macOS）或build-essential（Ubuntu） - 确保 C/C++ 文件包含合法的
main()函数，且无语法错误；undefined reference to main通常意味着文件里根本没写main，或函数签名写成了void main()（应为int main()） - 默认配置用
gcc编译 C，g++编译 C++；若混用，可在文件顶部加注释告诉 Code Runner 语言类型：// @language=c或// @language=cpp - 需要链接库时（如
-lm），不能只靠默认配置，得自定义 executorMap，例如：
"c": "gcc -o $fileNameWithoutExt $fileName -lm && ./$fileNameWithoutExt"
路径和权限问题比想象中常见：生成的可执行文件可能被杀毒软件拦截，或 macOS 上因未签名被阻止运行，此时需手动 chmod +x 并确认安全设置。
