sublime text 中 docblockr 插件装不上需先确认 package control 正常工作，重装最新版安装脚本；搜索时输入全小写 docblockr；触发注释需光标位于函数声明正上方空行，输入/**后按enter；配置修改须在 settings – user 中进行并重启生效。
Sublime Text 里 DocBlockr 插件装不上？先确认 Package Control 是活的
很多用户点完“Install Package”没反应，或者搜 DocBlockr 找不到——根本不是插件下架了，而是 Package Control 本身没装好或卡住了。
常见错误现象：Package Control: Install Package 命令不出现、命令面板里搜不到 Package Control、安装后重启 Sublime 还是空白。
- 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），输入Package Control: Install Package—— 如果没这个选项，说明Package Control没装成功，得重装 - 别用官网旧版安装脚本；直接去 packagecontrol.io/installation 复制最新 Python 安装代码，粘贴进 Sublime 的
View → Show Console（快捷键Ctrl+`）里回车执行 - 执行完别急着关控制台，等它输出
Package Control initialized.再重启 Sublime - Windows 用户如果用代理或公司网络，
Package Control可能静默失败；可临时改配置项http_timeout或换源（但多数情况重装比调配置快）
搜不到 DocBlockr？注意名字拼写和大小写
在 Package Control 里搜 docblockr（全小写）能出来，但搜 DocBlockr 或 docblock 就可能漏掉——它注册的包名就是小写的 docblockr，不是驼峰也不是复数。
- 命令面板输入
Package Control: Install Package，回车后等几秒，等搜索框光标闪烁再敲docblockr - 别输太快，Sublime 包搜索是模糊匹配，但首字母错或漏字母就直接没结果
- 装完不会弹提示，看右下角状态栏有没有闪一下
DocBlockr installed；不确定的话，再开命令面板搜DocBlockr，能看到一堆以它开头的命令（比如DocBlockr: Toggle DocBlock）就对了 - Mac 用户如果用 Sublime Text 4，确认你装的是官方维护版（作者是
nokome），别误装了同名但已停更的旧 fork
按 Tab 不生成注释？检查触发符号和光标位置
装完插件不代表自动生效——DocBlockr 默认只在函数定义行上方、且光标在空行时，输入 /** + Enter 或 Tab 才触发。不是所有地方打斜杠都管用。
- 必须把光标放在函数/方法声明的正上方一行，且该行为空（不能有空格或制表符）
- 输入
/**后立刻按Enter（不是Tab），它会自动生成基础块；之后再按Tab跳转填参数 - JavaScript/TypeScript 中，如果函数用了箭头函数或没写
function关键字（比如const foo = () => {}），DocBlockr可能识别失败——这时手动补上function声明，或用命令面板运行DocBlockr: Toggle DocBlock - PHP 用户注意：默认不支持
fn()短闭包，得关掉jsdocs_allow_short_functions配置项，否则注释格式错乱
生成的注释字段不对？改 user settings 别碰 default
DocBlockr 的默认模板是通用型的，但 PHP 项目要 @param 类型在前，JS 项目要 JSDoc 格式，硬套容易出 @return {string} 这种错位写法。
- 改配置必须改
Preferences → Package Settings → DocBlockr → Settings – User，千万别动Settings – Default - 常用调整项：
jsdocs_spacer_between_sections设为true让参数和返回值之间空一行；jsdocs_indent_with_tabs设为false避免混用空格和 tab - 想加自定义字段（比如
@since或@example），在jsdocs_extra_tags里加数组：["@since", "@example"] - Sublime Text 4 用户注意：部分老配置项（如
jsdocs_simple_mode）已被移除，启用会报错；查 GitHub README 的 v4 兼容列表再配
最常被忽略的是：改完 settings 不重启 Sublime，也不重开文件，新配置就不生效。还有人把 docblockr 和 DoxyDoxygen 搞混，后者是 C++/C 专用，不支持 JS/PHP 的自动参数提取。
