Atom右键菜单自定义必须手动编辑context-menu.cson文件,选择器需精准匹配DOM(如.tree-view .file),command须真实存在且命名规范,修改后保存即生效但无错误提示,需用开发者工具验证。

Atom 编辑器内部右键菜单(比如项目树、编辑器区域)不能通过图形界面添加,所有自定义项都必须手动编辑 context-menu.cson 文件;写错一个引号、空格或选择器,菜单项就完全不出现,且无任何错误提示。
项目树(.tree-view)右键加命令:选对选择器是关键
你右键点的是文件或文件夹,但菜单没出来?90% 是选择器没命中。Atom 用 CSS 选择器实时匹配 DOM,不是靠功能类型判断。
-
.tree-view .file:只对单个文件行生效(含.js、.py等) -
.tree-view .directory:只对带三角箭头的文件夹行生效 -
.tree-view:整个树容器,包括空白区域右键(但优先级低于前两者) - 必须有空格:
.tree-view.file(连写)≠.tree-view .file(后代选择器) - 要过滤 JS 文件,得写成
'[data-path$=".js"]',不加引号会解析失败
菜单项点了没反应?先确认 command 是否真实存在
Atom 不校验 command 值是否有效,无效就静默忽略——点了等于没点。
- 按
Ctrl+Shift+P打开命令面板,搜关键词(如tree-view:remove),确认你要绑的命令已注册 - 插件自定义命令必须在
activate()中用atom.commands.add注册,且命名空间一致(如my-plugin:reveal-in-finder) - 大小写敏感:
core:save✅,core:Save❌ - 别拼错命名空间:
tree-view:move是官方命令,tree-view:move-file就是无效字符串
编辑器区域(代码区)右键加“复制路径”等命令
这个菜单和项目树是两套配置,绑定位置不同,不能混用。
- 路径是
menus/win32.cson(Windows)、menus/darwin.cson(macOS)、menus/linux.cson(Linux) - 必须加在
'context-menu':下的'atom-text-editor, .overlayer': [ ]数组里 - 示例:添加“复制文件路径”,插入这一行:
{label: 'Copy File Path', command: 'editor:copy-path'} - 该菜单只出现在编辑器内容区右键,不会在项目树或状态栏出现
最容易被忽略的是:改完 context-menu.cson 后不重启 Atom,也不 reload window,就以为没生效;其实保存即生效,但若选择器或 command 写错,它根本不会渲染出来——连报错都没有,只能靠开发者工具(Ctrl+Shift+I)Inspect 元素、核对选择器、再查命令面板验证 command 是否存在。

















