apm 随 Atom 安装但 macOS 需手动注册 Shell 命令；报 command not found 时应通过 Atom 菜单安装 Shell 命令并重启终端；插件不兼容需检查 engines.atom 版本范围，避免盲目使用 --compatible 参数。
apm 不是独立安装的工具，它随 Atom 编辑器一起部署；但 macOS 用户常因 Shell 命令未注册而误以为“没装好”——这不是 bug，是 PATH 配置缺失。
apm --version 报 command not found 怎么办
这是 macOS 上最常见、也最容易被当成“安装失败”的假问题。Atom 1.60+ 默认不自动写入系统 PATH，即使你已安装 Atom，终端里也找不到 apm。
- 打开 Atom → 菜单栏 Atom > Install Shell Commands，按提示输入系统密码完成注册
- 重启终端（不是 Atom，是 Terminal / iTerm / 终端应用本身）
- 再运行
apm --version，应输出类似apm 2.6.2 - Windows/Linux 用户通常无此步骤，直接可用；若失败，请确认是否以普通用户权限运行（非管理员/Root）
apm install 报 No available version compatible with your Atom version
这不是网络或权限问题，而是插件已停止维护，或其 package.json 中的 engines.atom 字段锁死了兼容版本范围。
- 先运行
atom --version确认当前 Atom 版本（2026 年主流为 1.60+） - 访问
https://atom.io/packages/包名，看页面右下角 “Compatible with Atom x.y.z” 是否覆盖你当前版本 - 若不兼容，可尝试降级 Atom（不推荐），或改用替代插件（如
linter-eslint替代已停更的linter-jshint） - 慎用
--compatible参数绕过检查：apm install --compatible linter-jshint可能导致插件崩溃或功能异常
批量安装与导出插件列表：apm list --installed --bare 和 apm install --packages-file
适合团队同步环境、重装系统后快速复原，或做 CI/CD 前置准备。
- 导出当前所有已安装插件（不含主题）：
apm list --installed --bare > my-packages.txt - 导入安装：
apm install --packages-file my-packages.txt - 注意：
--bare输出只有包名（如emmet），不含版本号；若需锁定版本，得手动编辑my-packages.txt改成emmet@2.4.3格式 - 导出时加
--json（apm list --json）可用于脚本解析，但需额外处理字段提取
从 Git 安装插件失败提示 Git not found
apm 依赖系统 Git 命令来克隆仓库，不是 Node.js 或 npm 的问题。
- 先在终端运行
git --version，确认 Git 已安装且在 PATH 中 - macOS 若用 Homebrew 安装过 Git，但终端仍报错，可能是 shell 配置未加载（检查
~/.zshrc或~/.bash_profile是否包含export PATH="/usr/local/bin:$PATH"） - Windows 用户请确认 Git for Windows 的安装选项勾选了 “Add Git to the system PATH”
- 绕过方式：下载 ZIP 包解压后用
apm link本地链接（见下条），但无法自动更新
真正容易被忽略的是插件兼容性验证这一步——很多人看到 apm install 成功就以为万事大吉，结果重启 Atom 后插件不生效、菜单不出现、甚至拖慢启动速度。务必核对插件页标注的 Atom 版本兼容范围，而不是只看安装日志里的 “done”。
