apm不可用是build插件安装失败的首要原因，需先通过Atom菜单（macOS）或安装选项（Windows）配置PATH；build本身不支持语言，须搭配build-gcc等专用插件，并在项目根目录创建.atom-build.yml配置构建命令。
Build 插件安装失败或找不到？先确认 apm 是否可用
Atom 的插件管理器 apm 必须能被系统识别，否则所有插件安装都会卡在“搜索无结果”或报错 command not found: apm。这不是 Atom 图形界面的问题，而是 shell 环境缺失。
- 在终端（macOS/Linux）或命令提示符/PowerShell（Windows）中运行
apm --version；若提示未找到，说明apm没加进 PATH - macOS：Atom 安装时会提供 “Install Shell Commands” 选项（菜单栏 Atom → Install Shell Commands），必须手动触发一次
- Windows：安装 Atom 时勾选 “Add to PATH”，或手动把
C:\Users\{user}\AppData\Local\atom\app-*.x\resources\app\apm\bin加入系统环境变量 - Linux（如 Deepin）：部分发行版的 Atom 包不自带
apm，需从官网下载 .deb/.rpm 安装包，而非用 snap 或 flatpak
build 插件安装后没反应？检查是否与其他构建插件冲突
build 是底层构建框架，它本身不带语言支持，必须配合 build-gcc、build-g++、build-java 等语言专用插件才能工作。单独装 build 不会自动识别 .c 或 .java 文件。
- 已安装
script插件？它和build都监听Ctrl+Shift+B，但逻辑互斥——禁用或卸载script再试 - 多个 build-* 插件共存时（比如同时装了
build-gcc和build-clang），Atom 默认只启用第一个，需手动在Settings → Packages → build → Targets中切换激活项 - 插件安装后未重启 Atom：某些插件（尤其是
build-gcc）依赖 Atom 启动时加载的模块路径，热安装无效
为什么按 Ctrl+Shift+B 没弹出构建面板？项目根目录缺配置文件
build 插件默认只在**当前打开的项目文件夹根目录下**查找配置文件，不是按文件类型自动匹配，也不是全局生效。没有配置，就等于没告诉它“该跑什么命令”。
- 必须在 Atom 中通过
File → Add Project Folder打开一个真实文件夹（不能只打开单个main.c文件） - 在该文件夹内新建文件
.atom-build.yml（注意开头的点），内容至少包含cmd和args，例如：
cmd: "gcc" args: ["-Wall", "-o", "a.out", "main.c"]
- Windows 用户注意：
args中不要用&&连接编译和运行，应拆成两个 target，或改用sh: true+cmd: "gcc ... && a.out" - Linux/macOS 下路径变量写法是
{FILE_ACTIVE}，不是/{FILE_ACTIVE}—— 后者是旧版文档误传，会导致路径拼接错误
构建成功但输出乱码或中文显示为问号？编码与终端环境不一致
Atom 底部构建面板本质是调起子进程并捕获 stdout/stderr，它的字符编码完全继承自宿主终端。Windows CMD 默认 GBK，而 gcc 输出 UTF-8，二者不匹配就会出现方块或问号。
- Windows 用户：在
.atom-build.yml中显式设置环境变量env: { "CHCP": "65001" }（启用 UTF-8），或改用 PowerShell 作为默认 shell（需设sh: true并指定shell: "powershell"） - macOS/Linux：确保终端 locale 是 UTF-8，运行
locale | grep UTF，若无输出，需在 shell 配置文件中添加export LANG=en_US.UTF-8 - Atom 自身编码设置（
Settings → Core → Default Encoding）只影响文件读写，不影响构建输出流
实际用起来，最常卡住的地方不是插件装没装，而是项目没以文件夹形式打开、配置文件名少了个点、或者 Windows 下没处理好编码切换。这些细节不试一遍根本意识不到。
