Atom已于2022年12月停止维护，docblockr等注释插件因API弃用和语法识别失效而无法正常工作，应改用语言原生snippet、jsdoc或eslint-plugin-jsdoc等现代方案。
Atom 已于 2022 年 12 月正式停止维护，apm 源下线，插件生态冻结，所有依赖 Atom 核心 API 的注释整理类插件（如 docblockr、atom-comment-block）不再接收更新，部分在新版 Electron 或 macOS / Windows 更新后已无法正常工作。
为什么 docblockr 在新项目里突然不生成注释模板了
这不是你配置错了，而是 docblockr 依赖的 atom-text-editor 生命周期钩子已被弃用，且其语法识别逻辑无法匹配现代语言服务器（如 TypeScript Server、pylsp）注入的 scope。尤其在使用 @typescript-eslint 或 Prettier 自动格式化后，光标位置与 AST 节点偏移错位，导致触发失败。
- 临时验证：打开开发者工具（
Cmd+Option+I），输入atom.packages.isPackageActive('docblockr')，返回false即说明插件未真正激活 - 替代方案不是重装，而是改用语言自带的 snippet —— 例如在 JavaScript 文件中输入
/**+Enter，原生支持已覆盖大部分场景 - 若强行启用，需降级 Atom 至 v1.58（最后稳定版），但会失去 Node.js 16+ 兼容性，且无法打开 WebAssembly 模块
想批量提取或校验注释，别碰 atom-comment-extractor
该插件最后一次更新是 2019 年，其正则模式 /\/\*\*[\s\S]*?\*\//g 无法处理嵌套注释、JSX 中的注释字符串、TypeScript JSDoc 泛型标注（如 /** @param {Array<string>} list */</string>），还会把 Markdown 文档里的 ```js 块误判为代码注释。
- 真实可用路径：用命令行工具，比如
jsdoc提取（jsdoc -r src/ -d docs/ --no-recurse），它基于 AST 解析，跳过字符串和注释块内的伪注释 - 轻量校验：用
eslint配合eslint-plugin-jsdoc，规则如jsdoc/require-jsdoc或jsdoc/check-param-names，比 Atom 插件更准且可 CI 集成 - 不要尝试用 Atom 的
Find in Project（Cmd+Shift+F）搜/**—— 它不支持多行匹配，会漏掉换行缩进的 JSDoc
如果必须用 Atom 做注释整理，只保留三个动作
放弃“自动整理”幻想，把 Atom 当作带语法高亮的文本编辑器来用，聚焦人工可控环节：
- 手动补全用
Tab触发内置 snippet：在函数定义上方空行敲/**→Enter，Atom 会自动补全@param和@return占位符（仅限 .js/.ts 文件，且文件必须已保存并有正确扩展名） - 统一风格靠
prettier-atom（非prettier-plus）：启用formatOnSave后，Prettier 会按prettier.config.js里的jsDocLineLength折行，避免手写注释超出 80 列 - 搜索替换限定 scope：在
Find in Buffer（Cmd+F）中勾选Only in Comment，再搜@deprecated，能精准定位待清理项，不会误伤代码里的字符串
现在还在用 Atom 整理注释的人，多数卡在“历史项目迁移没完成”或“团队规范强制要求”。真要长期维护，注释结构本身比编辑器更重要 —— 比如 JSDoc 是否带 @see 链接、是否用 @example 而非注释内写代码，这些 Atom 一个都管不了。
