atom本身不运行代码，所有构建和执行均调用系统命令；90%失败源于path、文件状态、语言识别或终端模式未正确配置，需确保文件已保存、右下角显示正确语言、启用ctrl+i终端模式并填入解释器绝对路径。
Atom 本身不编译、不运行代码，所有“构建”和“执行”动作都靠调用系统命令完成；配置失败的根源90%在路径、权限、文件状态或插件兼容性上，而不是插件没装全。
build 插件找不到 gcc/php/python？先查 PATH 和启动方式
Atom 启动时继承的是图形界面环境的 PATH，不是你终端里生效的那个。which gcc 在终端能返回结果，但在 Atom 里报 command not found，大概率是 Atom 从桌面图标启动的。
- macOS：关掉 Atom，从终端执行
atom .再打开项目 - Windows：任务管理器结束所有
atom.exe进程，再从命令行启动 - Linux：确保
~/.profile或~/.bashrc中的 PATH 已导出，且桌面环境加载了它（GNOME 可能需改~/.profile） - 实在不行，把命令写成绝对路径，比如
/opt/homebrew/bin/php或/usr/bin/gcc
.atom-build.json 放哪？格式和字段怎么写才有效
这个文件必须放在当前项目的根目录，不是 ~/.atom/，也不是子文件夹里。build 插件只认当前工作区根目录下的配置。
- 必须有
cmd字段，值是字符串（如"php"），不能是数组 -
args是数组，文件路径要用占位符："{FILE_ACTIVE}"（完整路径）、"{FILE_BASE_NAME}"（不含扩展名）、"{FILE_PATH}"（所在目录） - 加
"sh": true才支持 shell 特性（如重定向、管道），否则gcc -o a.out main.c && ./a.out会失败 - JSON 末尾不能有多余逗号，引号必须是英文半角，建议用 VS Code 或在线 JSON 校验工具过一遍
script 插件运行卡住或没输出？检查这三件事
script 插件最常静默失败——它不报错，只是不吐内容。问题几乎都出在运行上下文上。
- 文件必须已保存，且后缀名正确：
hello.py才触发 Python 解释器，hello（无后缀）默认走bash - 右下角 grammar 必须手动设为对应语言（点开它选
Python，别留着Plain Text） - 必须按
Ctrl+I（Win/Linux）或Cmd+I（macOS）启用终端模式，否则含input()的脚本会挂起 - Python 输出缓冲：在
print()加flush=True，或把插件的 Command 改成python -u
C/C++/Java 编译运行别硬套一个插件
试图用 script 一键编译+运行 C++ 或 Java，很快会撞墙。这些语言需要分离编译、链接、执行三步，且依赖文件状态和工作目录。
- C/C++：用
build+ 自定义.atom-build.json，编译和运行拆成两个配置（一个gcc -o {FILE_BASE_NAME} {FILE_ACTIVE}，另一个./{FILE_BASE_NAME}），并确保chmod +x权限 - Java：别指望
script自动javac+java。装java-build插件，它专为 classpath、源码结构和.jar依赖设计 - Java 编译失败常见原因：
javac找不到（PATH 问题）、源文件名与 public class 名不一致、未在包声明的子目录下打开文件
最易被忽略的点：所有构建行为都依赖“当前激活文件”的路径和后缀，而不是你脑中想编译的那一个。切换标签页、保存、确认 grammar、再按快捷键——顺序错了，就白配。
