DocBlockr 是第三方 Sublime 插件，用于自动补全函数/类注释块；Sublime 默认不带它，需通过 Package Control 安装，并依赖正确语言模式和函数声明格式才能正常工作。
DocBlockr 是什么，为什么 Sublime 默认没有它
DocBlockr 不是 Sublime 自带功能，而是第三方插件，专门解决写函数/类注释时重复敲 /**、手动对齐 @param、补全参数名这些琐事。它不改编辑器核心，只在你敲 /** 回车后自动展开成结构化注释块——但前提是得装上它，且 Python 环境得能跑 Package Control。
用 Package Control 安装 DocBlockr（最稳路径）
别去 GitHub 下 zip 手动解压，容易漏依赖或路径错。Package Control 是 Sublime 插件的事实标准分发渠道，只要它正常工作，安装就几乎不会翻车：
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），调出命令面板 - 输入
Install Package，回车选中Package Control: Install Package - 等几秒加载完成，再输
DocBlockr，出现后回车确认 - 安装完不用重启，直接新建一个
.js或.py文件试试：在函数上方敲/**+Enter，看是否自动补全
常见失败点：Package Control 本身没装好（比如报 There are no packages available for installation），这时候得先重装 Package Control，而不是硬试 DocBlockr。
注释自动生成失效？检查语言模式和触发位置
DocBlockr 不是全局生效的魔法，它严格依赖当前文件的语言语法高亮模式，以及光标是否在“合理位置”：
- 确保右下角显示的是
JavaScript、Python、PHP等它支持的语言，不是Plain Text或HTML（DocBlockr 对 HTML 不处理函数注释） - 必须把光标放在函数定义行的正上方，且前面不能有空行或非注释内容；比如下面这样不行：
function foo() {上面隔了一行空行，/**就不会触发生成 - 某些语法（如箭头函数
const bar = () => {}）可能不被识别为“可注释函数”，建议优先用于function声明或class方法 - 如果用了 Babel 或 TypeScript 插件，有时会覆盖语法定义，导致 DocBlockr 检测不到函数签名——临时切回原生
JavaScript模式试试
参数提取不准、@param 为空？别怪插件，先看函数写法
DocBlockr 的参数名是从函数声明里“扒”出来的，不是猜的。它解析的是形参列表，不是变量名或解构赋值内部：
- 支持：
function getData(id, name) {}→ 能正确生成两个@param - 不支持：
function getData({ id, name }) {}→ 只看到一个参数obj，不会拆解对象属性 - 也不支持：
const fn = (a, b) => a + b
→ 匿名函数赋值，DocBlockr 默认不处理（除非你装了额外补丁或换用ESDoc类工具） - 如果你用 JSDoc 标签如
@param {string} id - 用户ID，DocBlockr 只填名字，类型和描述得自己补——它不读类型系统，也不连 ESLint 或 TypeScript
复杂函数签名、TS 接口、装饰器方法这些，DocBlockr 天然不覆盖。真要深度集成，得上 ts-jsdoc 或 VS Code + Document This 这类更重的方案。
