atom插件默认路径是~/.atom/packages（macos/linux）或c:\users{用户名}.atom\packages（windows），最权威确认方式是在开发者工具console中执行atom.packages.getpackagedirpaths()，返回数组首项即主目录。
怎么快速确认插件装在哪
Atom 插件默认路径不是靠猜或查文档，而是直接问 Atom 自己。打开开发者工具（Ctrl+Shift+I 或 Cmd+Option+I），切到 Console 标签页，执行：
atom.packages.getPackageDirPaths()
返回数组的第一个值就是主插件目录：~/.atom/packages（macOS/Linux）或 C:\Users\{用户名}\.atom\packages（Windows）。这个结果比环境变量、注册表或手动翻文件夹更可靠，尤其当你用过便携版或改过配置时。
常见错觉：
-
apm list只显示包名和版本，不输出路径 - Windows 上找
C:\Program Files\Atom是白忙——用户插件从不写进安装目录 - 看不到
packages文件夹？它被系统隐藏了：Windows 需勾选“显示隐藏的项目”，macOS/Linux 按Cmd/Ctrl+Shift+.切换显示
禁用 vs 卸载：别用错命令
禁用插件是开关操作，不是删文件；卸载是彻底删除。两者完全不等价，且不能混用。
正确做法：
- 在 Settings → Packages 里搜插件名，点右侧开关按钮——立即生效，无需重启
-
apm命令没有enable或disable子命令，它只管安装/升级/卸载 -
apm uninstall <package-name></package-name>会删掉整个文件夹，之后要重装才能恢复
注意依赖关系：比如 linter-ui-default 依赖 linter，只禁用前者而留着后者，可能触发 UI 错误或控制台报错 Cannot find module 'linter'。
本地安装插件时必须处理 node_modules
很多插件（尤其是 Linter 类、Beautifier 类）带 node_modules 依赖，直接扔进 packages 目录不会自动安装依赖，启动时会报错或功能缺失。
必须手动补上：
- 解压后确保文件夹名和
package.json中的"name"字段**完全一致**（大小写敏感） - 终端 cd 进该插件目录，运行
npm install（或墙内用cnpm install） - 若网络不稳定导致安装失败，可提前下载好
node_modules压缩包，解压后放进对应插件目录
漏掉这步的典型现象：Failed to activate package 'xxx' because Cannot find module 'yyy'。
备份和迁移插件的唯一可靠方式
sync-settings 插件在 2026 年已彻底失效——GitHub Gist API 写权限限制 + Atom 1.75+ OAuth 流程中断，导致 Backup/Restore 静默失败或返回 403 Forbidden。
当前唯一可验证、可重试的方案是手动 git 管理：
- 导出插件清单：
apm list --installed --bare > packages.txt - 把
~/.atom/config.cson、keymap.cson、snippets.cson、styles.less和packages.txt加入私有 git 仓库 - 新机器上：
git clone后执行apm install --packages-file packages.txt
关键提醒：packages.txt 不保存插件配置项（如 linter-eslint 的规则路径）、UI 布局状态或弹窗提示开关——这些都得手动同步到 config.cson 里，否则还原后功能不完整。
