Git克隆插件成功率更高，因绕过apm网络链路；需确保git、node.js已安装且目标目录为~/.atom/packages；操作分四步：进目录、克隆镜像仓库、进文件夹、npm install；注意文件夹名、package.json一致性及插件兼容性。
为什么用 Git 克隆装插件而不是 Settings 里点安装
因为 apm install 或 Settings 界面安装常卡在下载阶段，尤其在国内网络环境下——apm 默认走 npm 官方源和 GitHub API，没配镜像或代理时基本超时失败。Git 克隆绕过了 apm 的网络请求链路，只依赖你能访问 GitHub（或镜像站）的能力，成功率高得多。
克隆前必须确认的三件事
缺一不可，否则 clone 后 npm install 会报错或插件不生效：
-
git已安装且能被命令行识别（运行git --version有输出） -
node.js已安装（npm是必需的，apm本身也基于 Node） - 目标目录是
~/.atom/packages（Windows 是C:\Users\{用户名}\.atom\packages），不是atom\app-xxx\resources\app\node_modules这类错误路径
实际操作：四步完成克隆 + 激活
以安装 atom-simplified-chinese-menu 为例（其他插件同理，替换仓库地址即可）：
1. 打开终端（Windows 用 Git Bash 或 CMD，macOS/Linux 用 Terminal）
2. 进入插件目录：cd ~/.atom/packages
3. 克隆仓库：git clone https://gitcode.com/gh_mirrors/at/atom-simplified-chinese-menu.git（注意：用 GitCode 镜像地址，比直连 GitHub 更稳）
4. 进入插件文件夹并安装依赖：cd atom-simplified-chinese-menu && npm install
完成后重启 Atom，或按 Ctrl+Alt+R 刷新界面。
常见失败点和对应解法
这些地方出错频率最高，但往往被忽略：
- 克隆后文件夹名含空格或特殊字符（如
atom-simplified-chinese-menu (fork)）→ 手动重命名为纯英文、无空格名，再cd -
npm install报Cannot find module 'nan'或类似编译错误 → 说明该插件含原生模块，需先全局装apm并执行apm rebuild（不是npm rebuild） - 重启 Atom 后插件没出现 → 检查
~/.atom/packages下该插件文件夹里是否有package.json，且其中"name"字段值与文件夹名**完全一致**（大小写敏感）
最麻烦的其实是插件本身已废弃（比如 atom-script），克隆完 npm install 成功，但 Atom 启动时报 require is not defined —— 这时候得看插件 README 是否注明支持 Atom 1.60+，不支持就别硬扛了。
