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} list */），还会把 Markdown 文档里的 ```js 块误判为代码注释。

AI工具箱导航

一款AI开发辅助工具，主要用于AMZ123旗下的AI工具导航网站，适合需要提升相关任务效率的用户。

下载

• 真实可用路径：用命令行工具，比如 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 一个都管不了。