context-menu.cson必须放在插件根目录的menus/子目录下,文件名严格为context-menu.cson,且需通过CSS选择器(如'atom-text-editor')匹配目标元素,command值须与atom.commands.add()注册的标识符完全一致。

context-menu.cson 文件必须放在插件的 menus/ 目录下
Atom 不会自动加载任意位置的菜单配置。你写的 context-menu.cson 必须严格放在插件根目录下的 menus/ 子目录中,否则右键菜单完全不会出现,且无任何报错提示。
常见错误包括:
- 把文件放在
lib/或src/下,Atom 启动时直接忽略 - 文件名写成
context_menu.cson(下划线)或ContextMenu.cson(大小写/驼峰),CSON 解析失败 - 插件未启用:即使文件路径对,
package.json里没声明"main",或activate()没执行,菜单也不生效
选择器写错会导致菜单“隐身”,不是不工作而是不匹配
上下文菜单靠 CSS 选择器触发,不是靠文件类型或光标位置。选错目标元素,菜单就永远不会弹出来。
最常用也最容易出错的选择器组合:
-
'atom-text-editor':只在编辑器内容区右键生效,点侧边栏、状态栏、树视图都不行 -
'atom-workspace':整个窗口区域有效,但常被更具体的选择器(如atom-pane)覆盖,优先级更低 -
'tree-view': [ ... ]:专门用于文件树右键,想加“在终端打开文件夹”就得绑这里 -
'[data-grammar~="source.js"]':带引号!漏掉引号会被当成无效语法,整段配置静默失效
调试建议:按 Ctrl+Shift+I 打开开发者工具,右键目标区域,看最外层 DOM 元素的 class 和 data-grammar 属性,再反推选择器。
command 值必须是已注册的命令标识符
菜单项的 command 字段不是随便起的名字,它必须和 atom.commands.add() 中注册的字符串完全一致,包括大小写和冒号位置。
例如这些写法都会失败:
-
command: 'my-package:format'→ 实际注册的是my-package:format-code -
command: 'core:Save'→ 正确应为core:save(小写 s) -
command: 'format-code'→ 缺少命名空间前缀,Atom 找不到该命令
查可用命令最可靠的方式:Ctrl+Shift+P 打开命令面板,输入关键词,看到的完整命令名就是可直接复用的 command 值。
Windows 上改注册表才能让资源管理器右键出现“用 Atom 打开”
这是两个完全独立的系统:Atom 内部的右键菜单(context-menu.cson)和 Windows 资源管理器的右键菜单(注册表)互不影响。想在桌面或文件夹空白处右键调用 Atom,必须手动改注册表。
关键点只有三个,缺一不可:
- 注册三处分支:
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\name\AppData\Local\atom\atom.exe,否则注册表解析失败
改完不用重启系统,但资源管理器会缓存菜单。执行 taskkill /f /im explorer.exe && start explorer.exe 立即刷新即可。漏掉任意一个分支,对应场景就永远不显示菜单。











