DocBlockr 在 Sublime Text 4 不能直接使用，需改用社区维护的 DoxyDoxygen：安装后重启，支持多语言注释生成，可配置为 JSDoc 换行格式，但类型推导依赖正则、对 TS 解构/箭头函数识别有限。
DocBlockr 在 Sublime Text 4 还能用吗
不能直接用。原版 DocBlockr 已停止维护，Sublime Text 4 默认禁用未签名插件，而旧版 DocBlockr 没有签名，安装后基本不响应快捷键或自动补全。
实际可用的是社区维护的分支：DocBlockr-React（支持 JS/TS/JSX）或更通用的 TrailingSpaces 配合手动优化——但真正稳定、适配 ST4 的替代品是 SublimeJsPrettier + ESLint 链路里自带的注释提示，或者干脆换用 DoxyDoxygen。
- 别在 Package Control 里搜
DocBlockr，它会装上老版本，白忙活 - ST4 启动时若弹出 “unsigned plugin disabled”，八成就是它
- 如果项目用 TypeScript，
DoxyDoxygen对@param类型推导更准，比硬套 JS 的DocBlockr更靠谱
用 Package Control 安装 DoxyDoxygen 的实操步骤
DoxyDoxygen 是目前 ST4 下最接近原 DocBlockr 体验的替代：支持 C/C++/Python/JavaScript/TypeScript，按 Ctrl+Alt+D（Win/Linux）或 Cmd+Alt+D（macOS）生成块注释，光标停在函数名上就能自动提取参数。
- 打开 Command Palette（
Ctrl+Shift+P），输Package Control: Install Package回车 - 搜
DoxyDoxygen，选中安装（不是DocBlockr，拼写差一个字母都不行） - 装完重启 Sublime（不重启，快捷键不生效）
- 在 JS 文件里写个函数，把光标放在函数名上，按
Ctrl+Alt+D，看是否生成带@param的注释块
注意：默认注释风格是 Doxygen 风格（/** */），如需 JSDoc 风格（/**\n * */ 换行格式），要改配置——见下一条。
DoxyDoxygen 怎么改成 JSDoc 格式输出
原生 DoxyDoxygen 默认用紧凑单行 /** @brief ... */，和主流编辑器（VS Code）、TypeScript 类型检查工具预期的换行 JSDoc 不一致，会导致 @returns 被忽略、IDE 不识别类型。
- 菜单栏选
Preferences → Package Settings → DoxyDoxygen → Settings - 在右侧用户设置里加这段：
{
"languages": {
"javascript": {
"template": "/**\n * ${cursor}\n */"
},
"typescript": {
"template": "/**\n * ${cursor}\n */"
}
}
}
保存后，再按 Ctrl+Alt+D 就会生成标准换行块；${cursor} 是光标占位符，可替换成 @param {string} name - \n@returns {number} 等固定模板，但建议留空，靠后续 Tab 键跳转填充更灵活。
为什么生成的 @param 类型经常为空或错乱
因为 DoxyDoxygen 不解析 AST，只靠正则匹配函数签名——遇到解构参数、箭头函数、TS 类型注解（如 (name: string)）就容易漏掉或误判。
- 普通 function 声明（
function foo(a, b) {）识别最稳 - 箭头函数（
const foo = (a, b) => {}）需确保等号和括号间无换行，否则正则断掉 - TS 参数带类型（
(a: string, b?: number)）会被当成普通字符串，@param里不会出现{string} - 解构参数（
({ id, name })）基本无法识别，建议手动补全或改用 JSDoc 插件Document This（但后者仅支持 VS Code）
真要强类型支持，别指望 Sublime 的注释插件——它定位就是轻量补全，不是类型系统。复杂项目该切 VS Code + ESDoc 或 TypeDoc 流程。
