Atom 编辑器右键菜单默认仅含基础编辑操作，因语言相关、项目级及路径工具命令需依赖上下文选择器匹配和显式绑定，未预置；自定义须通过CSON配置或插件注入，且须确保选择器准确、命令已注册、插件启用。
Atom 编辑器内部的右键菜单（context menu）本身不带“查找文件”“格式化”“复制路径”等常用命令，所有这些都得靠手动配置 CSON 菜单文件或安装插件来注入——不是开箱即用，也不是注册表能解决的事。
为什么右键菜单默认没几个实用项
Atom 原生右键菜单只包含极简集合：复制、粘贴、撤销、重做、全选等基础编辑操作。它不预置语言相关命令（如 PHP 格式化）、项目级操作（如在当前目录新建文件）或路径工具（如复制文件绝对路径），因为这些行为依赖上下文选择器匹配和显式命令绑定。
- 菜单项是否出现，取决于你右键点击的 DOM 元素是否匹配
menus/context-menu.cson中定义的 CSS 选择器（例如'atom-text-editor'、'.tree-view'、'.tab'） - 没写对选择器，命令就永远不会显示；写错一个引号或逗号，整段菜单配置失效且无提示
- Windows/macOS/Linux 系统资源管理器里的右键菜单（如“用 Atom 打开”）和 Atom 编辑器内部右键菜单是两套完全独立的系统，互相不感知
如何给编辑器区域添加「复制文件路径」
这是最常被问、也最容易配错的自定义项。它只在你右键点击已打开的代码编辑区（即 atom-text-editor）时生效，不会出现在树视图或空白处。
- 找到对应系统的菜单文件：
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'} - 保存后立即生效，无需重启；但若右键点的是侧边栏或状态栏，该选项不会出现——它只绑定在编辑器内容区
如何为树视图（文件列表）添加「在终端中打开」
想右键项目树里某个文件夹，直接唤起终端并 cd 进去？这需要匹配 .tree-view 选择器，并调用第三方插件命令。
- 先装插件：
platformio-ide-terminal或term（确保已启用） - 编辑
menus/context-menu.cson（推荐放插件包内，而非全局） - 加入这段（注意缩进与引号）：
'tree-view': [ {label: 'Open in Terminal', command: 'platformio-ide-terminal:toggle'} ] - 该命令实际效果是打开终端面板并自动执行
cd /path/to/folder，前提是右键目标是文件夹节点；若点的是文件，部分插件会 fallback 到其父目录 - 别用
'core:open-in-browser'类命令填坑——它不处理路径，只打开 URL
自定义命令不显示？优先检查三件事
90% 的失败不是语法问题，而是上下文错位或命令未注册。
-
atom-text-editor选择器只匹配已打开的文件内容区，不匹配未激活 tab 或纯文本输入框 - 命令名必须和
atom.commands.add()中注册的完全一致，包括大小写和冒号位置，比如'my-package:format'≠'myPackage:format' - 如果用了插件命令（如
'php-cs-fixer:fix'），要确认插件已启用且其主模块成功加载；禁用再启用一次常比重启更有效
真正麻烦的从来不是加一行菜单，而是让那行命令在正确的时机、正确的元素上、以正确的参数跑起来——选择器、作用域、命令生命周期，三者缺一不可。
