Docblockr按Enter无反应，因光标未置于函数声明行正上方空行处，且需确保语言模式正确（如source.js）、语法高亮已识别该函数。
Atom 本身不内置自动生成代码注释功能，但可通过插件实现，核心依赖 docblockr（支持 JavaScript、PHP、Python、C/C++、Java 等主流语言）。
安装 docblockr 插件后为什么按 Enter 没反应？
常见原因是未在函数/方法定义上方正确触发——docblockr 要求光标必须紧贴在函数声明行的正上方，且该行需为空或仅含空白符。
- ✅ 正确位置：
/** * */
光标在/**上方空行处，输入/**后回车 - ❌ 错误位置：光标在函数内部、注释中间、或函数名同一行后方
- ⚠️ 注意：部分语言（如 Python）需额外启用
docblockr-python子插件，且仅对def和class有效，不处理普通变量
如何让 docblockr 自动填充参数和返回值？
它能解析函数签名，但依赖语法高亮准确性和语言支持粒度。JavaScript 支持最好，Python 次之，TypeScript 需配合 atom-typescript 才能读取类型注解。
- 函数形参自动提取：写好
function foo(a, b, cb)，光标在函数上一行输/**回车，会生成@param {any} a等 - 返回值需手动补全：
@return行默认为空，不会猜类型；加 JSDoc 注释如/** @returns {string} */可提升准确性 - 禁用自动填充：在设置里关掉
Auto-identify function names and parameters，避免误匹配
注释模板不满足项目规范怎么办？
docblockr 允许自定义模板，路径为 ~/.atom/config.cson 中的 docblockr 节点，但直接改配置易出错，推荐用插件内建方式：
- 打开命令面板（
Cmd+Shift+P/Ctrl+Shift+P），运行Docblockr: Edit Templates - 修改对应语言的
function模板，例如在@param后加{@link}或换行留空 - 保存后重启 Atom 生效；注意缩进必须用空格（非 Tab），否则解析失败
真正卡住的地方往往不是插件装没装，而是光标位置、语言模式是否激活（右下角显示 JavaScript 还是 Plain text），以及函数体是否已被 Atom 语法解析器识别为可注释节点——比如箭头函数若未被正确高亮，docblockr 就无法提取参数。
