Sublime Text需通过Package Control安装DocBlockr插件并配置jsdocs_auto_add_method_tag等选项才能自动生成含@param的函数注释，手动安装易失效，且要求语法识别正确、快捷键未冲突、Sublime版本≥3148。
Sublime Text 本身不自带 DocBlockr，但可以通过 Package Control 正确安装并立即生效——前提是别选错包名，也别手动下载 ZIP 解压到错误目录。
用 Package Control 安装 DocBlockr（推荐）
这是唯一稳定、可更新的方式。手动放文件夹容易因路径错误或版本不匹配导致 ctrl+alt+D 没反应。
- 确保已安装
Package Control：按Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Install Package Control并回车（如未安装） - 再次调出命令面板，输入
Package Control: Install Package回车 - 等待列表加载完成，输入
DocBlockr（注意拼写，不是DocBlock或Doxygen） - 选择并回车，几秒后右下角会提示
Successfully installed DocBlockr
安装后怎么用函数注释快捷键
DocBlockr 默认绑定 ctrl+alt+D（Windows/Linux）或 cmd+alt+D（macOS）生成注释块，但必须光标停在函数定义行上方（空行或紧贴函数声明前）。
- 支持的函数声明格式包括：
function name() {、const fn = () => {}、class A { method() {} }、def method(self):（Python） - 如果光标在函数体内或参数行，会生成空的
/** */，不会自动提取参数名 - 想让参数自动填充，需开启
jsdocs_auto_add_method_tag和jsdocs_include_author等设置（见下一条）
关键配置项要改，否则注释很简陋
默认配置几乎不填 @param 和 @return，看起来像没生效。打开 Preferences → Package Settings → DocBlockr → Settings，修改以下字段：
{
"jsdocs_auto_add_method_tag": true,
"jsdocs_auto_add_default_values": true,
"jsdocs_spacer_between_sections": true,
"jsdocs_indentation_spaces": 4,
"jsdocs_extra_tags": [
"@author",
"@version"
]
}
-
jsdocs_auto_add_method_tag控制是否加@method标签（JS 类方法需要） -
jsdocs_auto_add_default_values决定是否从function(a = 1, b)中提取默认值写进@param - 如果项目用 TypeScript，建议额外加
"jsdocs_parse_param_description": true来解析 JSDoc 注释里的类型描述
常见失效原因和排查点
装完没反应？大概率是这几个地方卡住了：
- 当前文件没有正确识别语法：检查右下角是否显示
JavaScript/Python，不是Plain text；可手动点击切换 - 快捷键被其他插件占用：在
Preferences → Key Bindings中搜索docblockr，确认ctrl+alt+D绑定的是doc_blockr命令 - 函数体用了箭头函数且无花括号：
const a = () => 1不会被识别，必须写成const a = () => { return 1; } - Sublime 版本太老：DocBlockr 要求 Sublime Text 3 build 3148+，旧版可能报
ImportError: No module named 'urllib.parse'
真正麻烦的不是安装，而是配置里那几个布尔开关——关着时生成的注释看着像占位符，开着才真正省时间。别跳过 Settings 文件。
