Sublime Text 4 用户应弃用已停止维护的DocBlockr，改用兼容ST4的DoxyDoxygen；它支持多语言、LSP集成，需注意Jinja2模板语法、键位冲突及配置适配。
Sublime Text 4 用户直接装 DocBlockr 基本会失败或生成空注释，它已停止维护，且不兼容 ST4 的 API 和异步加载机制；ST3 用户也需注意 Python 3.8+ 下 inspect.getargspec 被弃用导致崩溃。真要一键生成 API 文档，得换插件、调配置、改模板，不是装完就完事。
ST4 用户别碰 DocBlockr，改用 DoxyDoxygen
官方仓库明确标为 “unmaintained”，在 ST4 上安装后按 Ctrl+Alt+D（Windows/Linux）或 Cmd+Alt+D（macOS）没反应，控制台报 AttributeError: 'NoneType' object has no attribute 'groups' 是典型症状。这不是你操作错，是插件底层解析逻辑在新 API 下直接崩了。
- 打开命令面板 →
Package Control: Install Package→ 搜DoxyDoxygen（注意拼写，不是 DocBlockr） - 装完无需重启，但必须确保当前文件语法模式正确（右下角显示
JavaScript或Python，不能是Plain Text） - 光标放在函数定义行（如
function getUser(id) {或def create_order(items):），按快捷键触发，不是敲/**回车 - 若用 TypeScript 或 Babel 插件，可能覆盖语法高亮，临时切回原生模式再试
ST3 用户还能用 DocBlockr，但得卡准触发位置和语法
它只在极有限条件下工作：函数必须用 function 关键字声明（const fn = () => {} 不识别），参数不能是解构（({ a, b }) 会漏掉），且光标必须严格位于函数正上方的空行——前面有空格、制表符、甚至注释都不行。
- 输入
/**后立刻按Enter（不是Tab），否则不展开 - 检查右下角语言模式：JS 文件被识别成
HTML或Plain Text时，DocBlockr完全静默 - 如果按
Tab没反应，去Preferences → Key Bindings搜docblockr，确认快捷键没被 Emmet 或其他插件劫持 - 中文 Windows 用户若见乱码字段（如
@author显示方块），检查fallback_encoding是否设为"UTF-8"
自定义 API 文档模板时，变量语法和条件判断必须重写
DoxyDoxygen 用 Jinja2 语法，和 DocBlockr 的 ${1:description} 完全不兼容。直接复制旧模板会导致字段消失、整行跳过，甚至模板解析失败。
-
@param循环必须写成：{% for param in params %}@param {param.type} {param.name}{% endfor %} - 想让
@return在无返回值时也显示，得包一层判断：{% if return_type %}@return {return_type}{% endif %} - 模板里所有变量去掉了
$和序号，比如{description}，不是${1:description} - JS 解构参数（如
(options = { timeout: 5000 })）要提取options.timeout，必须开启配置项js_extract_destructured_params
真正卡住人的从来不是“怎么装”，而是哪几处一错就全废
装完插件发现没反应，90% 情况不是插件问题，而是三个点串错了：语法模式不对 → 触发位置不空 → 函数声明不符合解析规则。ST4 用户还多一层：插件根本跑不起来。模板自定义时最容易忽略的是条件包裹和变量语法切换，看着配置生效了，其实字段早被跳过。这些点不串起来排查，装十遍也没用。
