atom需依赖外部工具执行代码，build插件默认无构建逻辑；php/c/c++运行失败主因是path未配置、配置文件位置/格式错误或环境隔离缺失；须结合build与linter插件实现编译+诊断闭环。
Ctrl+Shift+B 运行却没反应？大概率是构建配置缺失或路径未识别。
为什么 build 插件找不到 php 或 gcc？
Atom 的 build 插件默认不带任何构建逻辑，它只负责调用你指定的命令。常见失败原因包括：
• 系统 PATH 中没有 php 或 gcc，which php 返回空
• .atom-build.json 放错位置（必须在项目根目录，不是用户主目录）
• JSON 格式错误，比如末尾多逗号、引号用中文全角、缺少 cmd 字段
• macOS 上用了 Homebrew 安装的 PHP，但插件读取的是系统默认 shell 环境（可能没加载 ~/.zshrc）
PHP 文件怎么一键运行并看到输出？
需要三步闭环：
• 安装 build 和 build-php 插件（后者非必需，但省去手写 JSON）
• 在项目根目录创建 .atom-build.json，内容如下：
{
"cmd": "php",
"args": ["{FILE_ACTIVE}"],
"sh": true,
"errorMatch": "Parse error|Fatal error|Warning"
}
• 确保当前打开的文件是 .php 后缀，且已保存（未保存文件无法被 {FILE_ACTIVE} 正确解析）
• 按 Ctrl+Shift+B（macOS 是 Cmd+Alt+B），输出会出现在底部面板
• 如果报 “command not found”，请改用绝对路径，例如 /opt/homebrew/bin/php（macOS Sonoma + Apple Silicon）
C/C++ 编译运行总卡在“no input files”？
这是 gcc-make-run 插件最典型的路径陷阱：
• 它默认只认 .c 或 .cpp 文件，且要求文件名不含空格或中文
• 不会自动加 -o 输出参数，所以编译后生成的可执行文件名是固定的（如 a.out），容易冲突
• 更可靠的做法是弃用该插件，改用通用 build + 自定义 JSON：
{
"cmd": "gcc",
"args": ["-o", "{FILE_BASE_NAME}", "{FILE_ACTIVE}", "-lm"],
"sh": true,
"cwd": "{FILE_PATH}",
"stdout": true,
"stderr": true
}
然后加一个独立的运行命令（用 build-tools 插件或再配一个 build 配置）：
• cmd: ./{FILE_BASE_NAME}
• 注意：第一次运行前需手动 chmod +x {FILE_BASE_NAME}，否则 Permission denied
测试时看不到错误详情或高亮定位？
单纯运行代码 ≠ 测试。真要捕获语法/逻辑问题，得靠静态检查层：
• PHP：装 linter-php，它调用 php -l 检查语法，保存即报错
• C/C++：装 linter-gcc，它依赖本地 gcc -fsyntax-only，错误直接标在行号旁
• 关键点：linter 类插件不执行代码，只做诊断；而 build 类插件不报错，只管跑命令
• 两者必须共存——就像医生先听诊（linter），再开药（build）
asdf / direnv 管理 shell 环境，要么每个项目都硬编码绝对路径到 .atom-build.json。别指望插件自动猜对。
