安装DocBlockr插件后，输入/**并回车即可自动生成函数注释，支持多语言参数识别与返回值标注，通过Tab跳转字段、快捷键提升效率，配合自定义设置实现标准化文档注释，提升代码可读性与团队协作效率。
在 Sublime Text 中使用 DocBlockr 插件可以快速生成规范化的函数注释，提升代码可读性和维护性。安装并正确配置后，只需简单操作即可自动生成符合主流风格的文档注释块。
安装与启用 DocBlockr 插件
通过 Package Control 安装是最快的方式：
- 按下 Ctrl+Shift+P 打开命令面板
- 输入 "Install Package" 并选择对应选项
- 搜索 "DocBlockr" 并点击安装
安装完成后无需额外启动，插件会自动生效。
生成函数注释的基本用法
将光标放在函数定义上方，输入 /** 后按回车，DocBlockr 会自动解析函数参数、返回类型等信息并填充注释模板。
- 支持 JavaScript、PHP、Python、Java 等多种语言
- 自动提取参数名，并预留描述位置
- 识别 @return、@throws 等标签
例如，在 JavaScript 中写完以下函数：
function calculateSum(a, b) { return a + b; }
在它上方输入 /** 回车后，会自动生成类似：
/** * calculateSum 的简要说明 * @param {number} a 第一个数 * @param {number} b 第二个数 * @return {number} 返回两数之和 */
规范化注释的实用技巧
为了让注释更标准、易读，建议遵循以下习惯：
- 每行注释不超过 80 字符，保持整洁
- 参数描述清晰具体，避免只写“参数”
- 添加 @author 或 @since 等项目需要的元信息（可在设置中配置）
- 多行注释时使用 tab 对齐参数类型和说明
可通过 Preferences → Package Settings → DocBlockr → Settings User 自定义模板字段。
提高效率的快捷键与小技巧
熟练掌握几个关键操作能大幅提升编码速度：
- 输入 /** 后按 Tab 快速跳转到下一个注释字段
- 在已有函数上重新触发 /** 可更新参数列表（如修改了形参）
- 使用 ctrl+alt+/ 快速插入块注释（部分版本支持）
- 在类属性前使用 /** 自动生成 @var 类型说明
配合语法高亮和缩进设置，注释结构一目了然。
基本上就这些。合理使用 DocBlockr 能让团队协作更顺畅，代码文档更专业。不复杂但容易忽略细节，坚持写好每一行注释，长期受益。
