DocBlockr 是 Sublime Text 的第三方注释模板插件，需通过 Package Control 安装，仅在支持语言（如 JS/PHP）且语法模式正确、触发符 /** 位于函数/类正上方时生效；ST4 用户应改用 DocBlockr-Alt 分支。
DocBlockr 是什么，为什么装了没反应
DocBlockr 不是 Sublime 自带功能，它是个第三方插件，作用是在函数、类等位置敲 /** 回车后自动生成注释模板。装了没反应，大概率是没正确安装或没触发对的语法环境。
- 必须用 Package Control 安装，手动丢文件进
Packages/目录容易漏依赖或路径错 - 只对支持的语言生效：默认支持
JavaScript、PHP、Python、Java等，但C或Go需额外配置或不支持 - 当前文件的语法模式（右下角显示）必须匹配，比如文件是
test.js但被识别成Plain Text，/**就不会触发
用 Package Control 正确安装 DocBlockr
别去 GitHub 下 ZIP 手动解压——路径错、权限错、少 sublime-package 文件都会导致失效。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），调出命令面板 - 输入
Package Control: Install Package，回车 - 等待列表加载完，再输入
DocBlockr，选中并回车 - 安装完成后不用重启，但建议关掉所有文件再重开一次，避免缓存干扰
写对触发符，且光标位置要准
/** 必须写在函数/方法/类定义的正上方，且前面不能有空行或非空白字符；否则插件判断不到上下文，直接当普通注释处理。
- ✅ 正确位置：
/** * */ function foo() {} - ❌ 错误位置：
console.log('hi'); /** * */ function foo() {}（前面有代码，不触发） - ❌ 错误写法：
/*或/**/，只有/**+ 换行才激活 DocBlockr - 参数提取依赖语言服务，
JavaScript能读function(a, b)，但const fn = (a, b) => {}可能解析失败，这是已知限制
常见报错和兼容性注意点
Sublime Text 4 用户会遇到 AttributeError: 'NoneType' object has no attribute 'groups' 这类错误，本质是 DocBlockr 原版未适配 ST4 的 API 变更。
- 解决办法：安装社区维护的分支
DocBlockr-Alt（同样通过 Package Control 搜索安装），它兼容 ST4 且持续更新 - 如果用了
NodeRepl或ESLint类插件，偶尔会和 DocBlockr 抢Tab行为，可在Preferences → Package Settings → DocBlockr → Settings中设"auto_indent": false - 中文 Windows 用户若发现注释里出现乱码字段（如
@author），检查 Sublime 的fallback_encoding设置是否为UTF-8
真正卡住人的不是“怎么装”，而是装完没反应时不知道该看语法模式、触发位置还是版本兼容性——这几个点串起来，基本覆盖 90% 的失败场景。
