vscode中/**回车无效是因jsdoc触发需满足语言模式、光标位置等前提：仅js/ts/py有效，光标须在函数声明行或其上空行，py需配置docstring风格；korofileheader最稳但模板变量名须英文；codegeex需登录并设zh-cn；snippet轻量但不解析代码。
为什么按/**回车没反应？
不是插件坏了，而是 VSCode 的 JSDoc 触发机制有硬性前提：/** 回车生效只在特定语言模式下起作用。常见失效场景包括：右下角语言模式显示为 Plain Text 或未识别类型；光标不在函数声明行（如 function getUser()）或其正上方空行；Python 文件未配置 docstring 风格。
实操建议：
- 先确认右下角语言标识是否为
javascript、typescript或python—— 点击它可手动切换 - Python 用户必须在设置中显式指定
python.docstringGenerator.style为google、numpy或restructuredtext，否则"""回车无效 - TypeScript 中若用
Document This，解构参数（如({ id, name }) => {}）和箭头函数表达式体（如const fn = () => "ok"）不会被解析，参数注释会漏掉
koroFileHeader 配置中文文件头与函数注释最稳
它不依赖语言服务，靠模板+变量驱动，对中文支持最直白可靠。关键点在于：模板里字段名（如 $description$）必须用英文，但值可以写中文；变量名不能写成 $功能说明$，否则插件无法替换。
实操建议：
- 在
settings.json中添加以下配置（注意双引号转义）：
{
"fileheader.customMade": {
"Author": "张三",
"Date": "Do not edit",
"Description": ""
},
"fileheader.configObj": {
"autoAdd": true,
"annotationStr": {
"head": "//",
"middle": "//",
"end": "//"
}
}
}
- 新建文件按
Ctrl+Alt+I插入文件头；光标停在函数定义行（如function getUser(id) {），按Ctrl+Alt+T生成带中文占位的函数注释 - 若想把
Description字段改成“功能说明”，模板里仍写"Description": "$description$"，只是人工填写时写中文描述
CodeGeeX 解释代码必须设为 zh-CN
默认解释语言常为英文，不手动切换就得不到中文注释。未登录状态下整个解释功能完全失效，右下角火箭图标不出现即代表不可用。
实操建议：
- 登录后，在设置中搜索
codegeex explanation language→ 选zh-CN - 选中目标代码（建议 ≤50 行）→ 按
Alt+T（macOS 为Option+T）→ 点explanation模板 - 右键 →
CodeGeeX Tool → Add Comment最省心，但注意：若光标不在选区末尾，注释可能错位到文件顶部 - 用
/comment指令更可控——光标落在函数定义行时，它能自动识别签名并生成含@param、@return的完整注释
自定义 snippet 轻量但需手动补全
适合固定结构、少量字段的注释模板，比如接口文档头或测试用例说明。它不解析代码结构，纯靠文本替换，所以参数名、返回值类型得自己填。
实操建议：
- 按
Ctrl+Shift+P→ 输入Configure User Snippets→ 选语言（如javascript） - 添加类似这样的片段：
"Chinese Func Header": {
"prefix": "chdr",
"body": [
"/**",
" * @description $1",
" * @param {$2} $3 - $4",
" * @returns {$5} $6",
" */"
],
"description": "中文函数注释模板"
}
- 输入
chdr+Tab即可展开，$1～$6用Tab键跳转补全 - 缺点明显：不感知类型、不校验参数数量、不自动提取函数签名——复杂函数仍得靠插件
中文注释生成不是“装了插件就完事”，真正卡住人的往往是语言模式、光标位置、模板变量命名这三处细节。尤其当项目混用 TypeScript 解构 + 箭头函数 + 中文描述时，Document This 会静默漏字段，CodeGeeX 若没设 zh-CN 就只吐英文，koroFileHeader 若把 $description$ 写成 $功能说明$ 就永远不替换——这些地方不试一次根本意识不到。
