atom插件开发必须显式配置package.json的main、activationhooks和engines字段，否则插件不加载、命令不注册；javascript插件需手动创建lib/目录并声明入口路径，且命令注册须在activate()内执行。
能开发，但得绕开几个默认陷阱——Atom插件加载器不自动认 lib/index.js，不填对 package.json 里的 main、activationHooks 和 engines，插件根本不会启动，命令也进不了命令面板。
用 apm init 创建项目但别直接写 index.js
执行 apm init --package my-plugin 后，默认生成的是 index.coffee 入口。如果你坚持用 JavaScript，必须手动创建 lib/ 目录，并在 package.json 中显式声明：
-
"main": "./lib/main.js"—— 路径错或留空 → 模块加载失败 -
"activationHooks": ["atom-workspace:pane-active"]—— 空数组或缺失 → 命令注册逻辑压根不执行 -
"engines": {"atom": ">=1.7.0"}—— 版本范围不匹配 →apm install静默跳过
注意：apm init -p my-plugin --syntax javascript 不会自动建 lib/ 目录，这一步必须手建，否则 require('./lib/main.js') 会报 Cannot find module。
activate() 里注册命令，别在模块顶层调 atom.commands.add
Atom 初始化完成前，atom 对象不可用。把命令注册写在模块顶层（即 lib/main.js 文件最外层），会导致 Uncaught ReferenceError: atom is not defined。
正确做法是只在 activate() 函数体内注册：
module.exports = {
activate() {
atom.commands.add('atom-text-editor', 'my-plugin:insert-timestamp', () => {
const editor = atom.workspace.getActiveTextEditor();
if (editor) editor.insertText(new Date().toISOString());
});
},
deactivate() {}
};
关键点：
- 作用域选
'atom-text-editor'表示只在编辑器有焦点时生效；选'atom-workspace'则全局可用，但需确认是否真需要 - 命令名必须是
namespace:action格式，比如my-plugin:insert-timestamp；写成myPlugin.insertTimestamp或insert-timestamp都搜不到 -
activationHooks和atom.commands.add的作用域要匹配，例如钩子写["text-editor:will-be-mounted"]，但命令注册在'atom-workspace'下，就可能延迟或失效
本地测试插件前先用 apm link 加载，别依赖“从文件安装”
在 Atom 设置里点“从文件安装”容易因路径权限、缓存或未重建符号链接导致加载失败，尤其 macOS 上常见。
推荐流程：
- 终端进入插件目录，运行
apm link（会软链到~/.atom/packages/） - 重启 Atom，或在命令面板执行
Window: Reload - 按
Cmd+Shift+P/Ctrl+Shift+P搜你的命令名，验证是否出现 - 出问题时打开开发者工具（
View → Developer → Toggle Developer Tools），看 Console 是否有Uncaught Error或 require 报错
如果命令面板里搜不到，优先检查三件事：package.json 的 activationHooks 是否非空、main 路径是否拼写正确、activate() 函数内是否真的调了 atom.commands.add。
发布前必须更新 package.json 版本号，且不能跳过 apm login
apm publish 会自动改 package.json 并打 Git tag，但前提是：
- 当前目录已是 Git 仓库，且已
git add+git commit所有变更 - 已执行
apm login绑定 Atom 账号（首次发布必做，否则报Unauthorized） - 版本号符合语义化规范（如
0.1.0），且不能和已有版本重复；apm publish patch会自动升0.1.0→0.1.1
容易被忽略的一点：apm publish 不上传 node_modules，但如果你在 dependencies 里写了运行时依赖（比如 lodash），就得确保它们在 package.json 中声明并执行过 apm install，否则用户安装后会缺模块。
