在 atom 编辑器中为文本编辑区域添加右键菜单项，最稳定方式是直接修改插件根目录下的 menus/context-menu.cson 文件，使用如 'atom-text-editor': [{label: 'copy file path', command: 'editor:copy-path'}] 的静态配置，确保命令已注册、选择器精确、语法无误，保存后立即生效。
如何在 Atom 编辑器中为文本编辑区域添加右键菜单项
直接改 menus/context-menu.cson 文件是最稳定、最可控的方式，Atom 不支持运行时动态注册右键菜单项，所有定义必须静态声明。
常见错误是把配置写进 menu.cson（这是顶部菜单栏）或错放路径——右键菜单配置只认 menus/context-menu.cson，且必须放在插件根目录下。
- 确保插件已启用：检查
atom.packages.isPackageActive('your-package-name')返回true - 命令标识符（
command字段）必须已通过atom.commands.add()注册，比如'my-package:toggle-highlight'，拼错大小写或未注册都会导致点击无反应 - 选择器要精确：
'atom-text-editor'仅对编辑器内容区生效；想同时覆盖代码高亮层，得写成'atom-text-editor, .overlayer'（逗号后不能有空格） - 保存文件后无需重启 Atom，但修改后右键没出现新选项，大概率是 CSON 语法错误（比如漏逗号、引号不匹配），Atom 不报错，只会静默忽略整段
为什么在项目树（tree-view）右键加菜单总不生效
因为项目树的 DOM 结构和编辑器完全不同，它用的是 .tree-view 类，不是 atom-text-editor。你得单独配选择器，否则菜单根本不会被触发。
- 正确选择器是
'.tree-view':或更精准的'.tree-view .file, .tree-view .directory' - 对应命令也得注册到合适作用域，比如
atom.commands.add('.tree-view', { 'my-package:open-in-terminal': () => {...} }) - 别指望一个选择器通吃：写
'atom-text-editor, .tree-view'是无效的，Atom 会分别匹配，但.tree-view没定义子项时仍不显示 - 如果菜单出现在项目树但点不动，检查是否被其他插件拦截——比如
platformio-ide-terminal会劫持.tree-view的右键事件
Windows 资源管理器右键“用 Atom 打开”怎么加才完整
这不是 Atom 插件能控制的，必须手动改 Windows 注册表，漏掉任意一个分支，对应场景就不出菜单。
- 三个注册表路径缺一不可：
HKEY_CLASSES_ROOT*shellOpen with Atom（单文件）、HKEY_CLASSES_ROOTDirectoryshellOpen with Atom（文件夹图标上右键）、HKEY_CLASSES_ROOTDirectoryBackgroundshellOpen with Atom（空白处右键） -
command值里：文件用"C:\path\to\atom.exe" "%1"，文件夹和背景必须用"%V"，不是"%1" - 反斜杠必须双写，
C:Users写成C:\Users，否则注册表解析失败 - 导入
.reg后执行taskkill /f /im explorer.exe && start explorer.exe刷新资源管理器，别等自动更新
自定义右键菜单容易被忽略的关键细节
最常踩的坑不是逻辑写错，而是上下文选择器和命令生命周期没对齐——比如在 deactivate() 里没解绑 atom.commands.add()，下次激活插件时命令重复注册，右键点一次触发两次。
-
context-menu.cson中的label支持 i18n 占位符，但插件没加载对应语言包时会显示原始 key，比如'menu.copy-path'而不是“复制路径” - 想让菜单项按条件显示（比如只在 JS 文件里出现），得用带语法过滤的选择器：
'[data-grammar~="source.js"]'，注意引号不能少 - 动态生成 label 或禁用状态？不行。CSON 是静态配置，如需动态行为，得用
created或shouldDisplay回调，但它们必须同步返回，且 event 对象不可序列化，不能存到全局变量里
