应安装 nikhilm 维护的 docblockr for sublime text 3（github 仓库 sublimetext-docblockr），装后重启，确保文件语法为 js/php/ts 等支持类型，在函数定义正上方输入 /** 后按 enter 才能正确生成注释。
Sublime Text 本身不自带 DocBlock 注释生成功能，但通过插件 DocBlockr（现维护版本为 DocBlockr for Sublime Text 3）可以一键生成符合 PHP/JS/TS/Python 等语言规范的函数注释块——前提是配置正确、触发方式用对，否则容易按了 Tab 没反应或生成空行。
怎么安装 DocBlockr 插件并确保它生效
别直接搜 “DocBlockr” 装错旧版；Sublime Text 3/4 应装社区维护的活跃分支：
- 打开
Command Palette（Ctrl+Shift+P/Cmd+Shift+P），输入Package Control: Install Package - 搜索并安装
DocBlockr（作者是nikhilm，GitHub 仓库名是sublimetext-docblockr） - 装完重启 Sublime（部分版本需手动重启才加载新插件）
- 验证是否生效：在 JS 或 PHP 文件中，输入
/**后按Enter，应自动补全基础注释结构
为什么敲完 /** + Enter 没反应
常见原因不是插件没装，而是文件语法类型没识别对，或快捷键被覆盖：
- 确认当前文件右下角显示的是
JavaScript、PHP、TypeScript等支持语言，不是Plain Text（点它手动切换） -
DocBlockr默认监听Enter，不是Tab；按Tab是在已有注释里跳转字段，不是生成注释 - 检查是否有其他插件（如
Emmet）劫持了Enter行为；可临时禁用其他插件测试 - 若仍无效，在
Preferences → Package Settings → DocBlockr → Settings中确认"auto_indent": true和"jsdoc_extra_tags"等基础项未被设为false
如何让 DocBlockr 正确提取函数名和参数
它依赖光标位置和代码上下文，不是 AI，所以必须“站在函数定义行上方”才能解析准确：
- 把光标放在函数声明的正上方一行（例如
function foo(a, b) {的上一行），再输/**+Enter - 支持的函数格式包括：
function name()、const name = () => {}、class A { method() {} }、def method(self):（Python） - 参数提取只读当前行括号内内容，不解析解构、默认值或类型注解（如
(a: string, ...rest: number[])会被简化为a, rest） - 若函数无显式参数（如
() => {}），它会生成空@param行，需手动删或补
生成后怎么快速填内容、避免手敲每个 @param
生成的占位符支持 Tab 键顺序跳转，但得知道默认字段顺序和编辑逻辑：
- 首次生成后，光标停在
@description区域；按Tab依次跳到每个@param、@return、@throws - 每个
@param行末尾有{type}占位符，删掉即可写具体类型（如{string}），留空也合法 - 想加自定义标签（如
@since、@example），可在Preferences → Package Settings → DocBlockr → Settings中修改"jsdoc_extra_tags"数组 - 注意：回车换行时，如果光标在注释块内，
DocBlockr会自动缩进下一行并补*；但退出注释块后这个行为就失效了
真正卡住人的往往不是不会装插件，而是光标没放对位置、文件语法类型没切对、或者误以为按 Tab 就能生成注释——它只负责补全，不负责理解业务逻辑。多试两次 /** + Enter 在不同上下文的位置，比查文档更快摸清边界。
