Ctrl+/不能批量注释多行的主因是右下角grammar显示为Plain Text，需手动设为Python/JavaScript等正确语法；选中多行时逐行加//或#，块注释需插件支持且依赖语法定义。
Ctrl+/ 不能批量注释多行？先确认 grammar 是否生效
Atom 的 Ctrl+/（macOS 是 Cmd+/）默认只对「已选中的行」逐行加行注释，但它根本不起作用的最常见原因，是右下角状态栏显示的 grammar 错了——比如 .py 文件被识别为 Plain text，那 Ctrl+/ 就只会插普通字符，不会加 #。务必点一下状态栏标签，手动选成 Python 或 JavaScript (Babel) 等真实语法；临时验证可按 Ctrl+Shift+P 输入 Grammar: Show Grammar 查看当前 scope。
想给函数自动加 /** */ 文档注释？得靠 DocBlockr 插件
原生 Atom 不支持输入 /** 后按 Tab 自动生成参数列表。必须装 docblockr 插件，并满足两个硬性条件：
• 光标必须落在函数/方法声明行（如 def foo(self, x): 或 function bar(a, b) { 整行任意位置）
• 当前 grammar 必须是它支持的 scope，例如 source.js、source.python；.vue 文件需进设置里把 text.html.vue 映射到 source.js
• 箭头函数、解构参数、TypeScript 类型标注等不被正则解析，会漏参或错位——这不是 bug，是设计限制
批量加头部作者/时间注释？atom-file-header 是唯一可靠方案
新建文件后想自动插入带 ${author} 和 ${date} 的头部注释，Atom 原生完全不支持。必须用 atom-file-header 插件，并严格配置三项：
• Author Name：手动填，不读 Git 配置
• Template：Python 模板必须顶格写 #，缩进错一个空格就失效
• Date Format：填 YYYY-MM-DD HH:mm:ss，小写 yyyy 会原样输出字面量
触发不是保存时自动发生，而是新建文件后按 Ctrl+Alt+I（macOS 是 Cmd+Alt+I）；${date} 只在首次插入时求值，后续改时间得重按一次
列模式追加注释？别用 End 键，用 Ctrl+→ 跳逻辑行尾
想在多行末尾统一加 # TODO，直接按 End 定位极不可靠——它停在“可视行尾”，可能被换行符、BOM 或零宽空格干扰，导致光标实际落在倒数第二个字符上。正确流程：
• 先用 Ctrl+Shift+↑/↓（macOS 是 Cmd+Shift+↑/↓）在目标行首加光标
• 再按 Ctrl+→（macOS 是 Cmd+→）跳到每行的逻辑结尾
• 直接输入空格和注释内容，所有光标同步响应
注意：如果缩进不一致，Ctrl+Shift+↑/↓ 加的光标会歪进字符串或注释里；此时应先装 atom-sublime-select 插件，用 Alt+拖拽 实现真正列对齐
真正容易被忽略的是：所有批量注释操作都依赖 grammar 正确识别，而 grammar 错误往往静默失败——没报错、没提示、只是什么都没发生。每次怀疑快捷键失灵，第一反应不该是查键位，而是低头看右下角那个小标签。
