Atom编辑器内部右键菜单必须手动编辑对应操作系统的menus/*.cson文件，如win32.cson；需严格匹配CSS选择器（如atom-text-editor）和已注册command，写错字符或命令未注册均导致菜单不显示且无报错。
Atom 编辑器内部的右键菜单（即编辑器区域、文件树等位置的上下文菜单）不能通过图形界面设置，必须手动编辑 CSON 配置文件；写错一个字符（比如多空格、引号不闭合、逗号遗漏），新菜单项就完全不出现，且无任何报错提示。
修改 menus/win32.cson（Windows）、menus/darwin.cson（macOS）或 menus/linux.cson（Linux）
Atom 按操作系统加载对应菜单文件，改错文件名或路径层级（如误写成 menu.cson 或放在错误目录）会导致配置彻底失效。文件必须放在插件包根目录下的 menus/ 子目录中，结构为：
my-package/ ├── menus/ │ └── win32.cson # Windows 专用 ├── lib/ └── package.json
内容示例（添加“复制文件路径”到编辑器右键）：
'context-menu':
'atom-text-editor': [
{label: 'Copy File Path', command: 'editor:copy-path'}
{type: 'separator'}
]-
atom-text-editor是 CSS 选择器，只对代码编辑区生效；若想在文件树（tree-view）右键也显示，需额外加.tree-view或.tree-view .file -
command值必须是 Atom 已注册的有效命令，比如core:save、application:open，或你自己的my-package:do-something（前提是已在activate()中用atom.commands.add注册） - 多个选择器用逗号分隔，中间**不能有空格**：
'atom-text-editor, .tree-view'✅，'atom-text-editor, .tree-view'❌（含不可见全角空格时常见）
确保 command 对应的功能已注册并启用
菜单项点击后没反应，90% 是因为 command 字符串未被 Atom 认可——它不是随便起的名字，而是命令系统中的唯一标识符。
- 查当前可用命令：按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入「Command Palette」，所有已注册命令都会列出 - 自定义命令必须在插件
activate()中显式绑定：atom.commands.add('atom-workspace', {'my-package:toggle': () => {...}}) - 大小写敏感：
core:Save≠core:save；拼错一个字母或冒号位置，就静默失败
Windows 资源管理器右键“用 Atom 打开”要改注册表，和编辑器内菜单无关
这是常被混淆的点：Atom 编辑器内部右键菜单（context-menu.cson）和 Windows 文件资源管理器右键菜单（注册表）是两套完全独立的机制。
- 要让资源管理器右键出现“用 Atom 打开”，必须手动导入 .reg 文件，且要同时覆盖三个注册表分支：
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" "%1" - 改完注册表后，执行
taskkill /f /im explorer.exe && start explorer.exe刷新资源管理器，否则菜单不更新
最易忽略的是选择器作用域和命令注册的耦合性：你写的菜单项是否出现，取决于 CSS 选择器是否匹配当前右键节点；而它能否点击生效，则取决于 command 字符串是否真实存在于 Atom 的命令注册表中——这两步缺一不可，且无中间反馈，调试时只能靠逐项核对。
