Atom编辑器内部右键菜单必须手动编辑CSON配置文件，Windows对应menus/win32.cson，macOS用darwin.cson，Linux用linux.cson；选择器需精确匹配如'atom-text-editor'，command须为已注册标识符，漏写、错写或路径错误均导致菜单不显示且无提示。
Atom 编辑器内部的右键菜单（即在编辑器区域、文件树等位置点击鼠标右键弹出的菜单）不能靠安装插件自动注入，必须手动编辑 CSON 配置文件；漏掉选择器、拼错 command 或写错路径层级，新菜单项就完全不出现，且无任何错误提示。
改哪个文件？看操作系统和生效范围
Atom 按系统加载不同菜单文件，改错文件 = 白忙活：
-
menus/win32.cson：仅 Windows 生效，含context-menu区块 -
menus/darwin.cson：仅 macOS 生效，注意它还包含「服务」集成逻辑 -
menus/linux.cson：仅 Linux 桌面环境（GNOME/KDE）生效
如果你开发的是跨平台包，三份都得同步改；如果只是本地调试，只动当前系统的那个。别把所有配置塞进一个文件——Atom 启动时只读取匹配平台的那份。
context-menu 里的选择器必须精确匹配 UI 元素
上下文菜单靠 CSS 选择器触发，不是靠文件类型或光标位置。常见失效原因就是选错了目标：
-
'atom-text-editor'：只对代码编辑区右键生效，不响应侧边栏、状态栏、空白处 -
'tree-view'：只对左侧文件树右键生效 -
'atom-workspace'：整个窗口区域，但常被更具体的选择器（如atom-pane）覆盖 - 多个选择器用逗号分隔：
'atom-text-editor, .overlayer'合法，'atom-text-editor .overlayer'（中间空格）则无效
示例：想让「复制文件路径」只在编辑器里出现，就写在 'atom-text-editor' 下；想让它也在文件树里出现，就得额外加到 'tree-view' 下。
command 必须已注册，否则点击没反应
菜单项的 command 字段不是随便起的名字，它必须是 Atom 已知的命令标识符：
- 内置命令如
core:save、editor:copy-path可直接用 - 自定义命令如
my-package:format-code，必须在activate()中通过atom.commands.add注册，且包已启用 - 大小写敏感：
core:Save≠core:save，后者才有效 - 查可用命令：按
Ctrl+Shift+P打开命令面板，输入关键词就能看到全部已注册命令
常见错误：在 CSON 里写了 command: 'my-package:do-something'，但主文件里没调用 atom.commands.add，或者 package.json 的 commands 字段没声明，结果右键点了没反应，也无报错。
Windows 资源管理器右键“用 Atom 打开”要改注册表
这个和编辑器内部菜单无关，是 Windows 系统级集成，必须手动操作注册表：
- 漏掉任意一个分支都会导致对应场景失效：
HKEY_CLASSES_ROOT*shellOpen with Atom（单文件）、HKEY_CLASSES_ROOTDirectoryshellOpen with Atom（文件夹）、HKEY_CLASSES_ROOTDirectoryBackgroundshellOpen with Atom（空白处） -
%1传文件路径，%V传文件夹路径——两者缺一不可 - 路径中反斜杠必须双写：
C:\Users\name\AppData\Local\atom\atom.exe，写成单斜杠会解析失败 - 图标异常？检查
Icon值是否为"C:path otom.exe",0 - 改完不用重启系统，但资源管理器可能缓存，执行
taskkill /f /im explorer.exe && start explorer.exe刷新即可
最常被忽略的一点：Atom 安装程序从不写注册表，无论你重装多少次，不手动导入 .reg 或逐条添加，资源管理器右键永远不会有“用 Atom 打开”——这不是 Bug，是设计如此。
