vs code 中 /** 回车无响应，需确认语言模式为 javascript/typescript/python 且光标位于函数声明行或其正上方空行；korofileheader 是支持中文注释最稳方案，可手动触发生成并人工补全解构参数等。
按/**回车没反应？先确认语言模式和光标位置
这不是插件坏了，而是 VS Code 的 JSDoc 触发机制有硬性前提：右下角语言模式必须是 javascript、typescript 或 python，不能是 Plain Text 或未识别类型；光标必须落在函数声明行（如 function getUser(id)）或其正上方空行，不能在函数体内部、注释块中间或变量声明后。
常见错误现象：新建 .js 文件写完函数按 /** 回车没反应 → 检查右下角是否显示 “JavaScript”，若显示 “Plain Text”，点击它手动选为 JavaScript；Python 场景下还需确保 python.docstringGenerator.style 设为 google、numpy 或 restructuredtext 之一，否则 """ 回车也无效。
koroFileHeader：中文文件头 + 函数注释最稳的落地方案
它不依赖语言服务，靠模板+变量驱动，对中文变量名、中文描述支持最直接。安装后在 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 自动生成带中文占位的 JSDoc 块，例如：
/**
* @description
* @param {any} id -
* @returns {any}
*/
模板里可直接写中文字段（如把 Description 改成“功能说明”），但变量名仍需用英文（如 $description$），否则插件无法替换。
微软正式发布 Visual Studio Code 1.118 版本 。本次更新重点强化了 AI 开发体验与企业管理能力，其中最引人注目的是新增 Copilot CLI 远程控制功能，允许开发者通过手机或网页远程监控和接管 AI 会话 。同时，为了提高 AI 的运行性价比，新版本优化了令牌缓存策略以降低成本 。此外，1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控 。
TypeScript 解构参数和箭头函数注释失败？别硬套 Document This
Document This 已停更，且明确不支持解构参数（如 ({ id, name }) => {}）和箭头函数表达式体（如 const fn = () => "ok"），会漏掉字段或根本无响应。实际项目中若大量使用这类写法，强行启用只会增加挫败感。
替代方案很务实：
- 用
koroFileHeader手动触发Ctrl+Alt+T，再人工补全解构字段（@param {number} id、@param {string} name） - 对箭头函数，先改写为具名函数声明再生成，注释完成后再改回（开发节奏允许时）
- 搭配
Better Comments标记待补注释点（如// ? 这里需要补充参数说明），避免遗漏
AI 类插件能自动生成中文注释，但别跳过人工校验
CodeGeeX 和 通义灵码 确实支持中文注释生成，中文理解率高（CodeGeeX 达 92%+），但它们生成的内容常存在三类问题：
- 变量名是中文时，注释里误写成拼音（如
用户名→ 注释写成userName而非username） - 对复杂业务逻辑只做字面翻译，缺乏语义提炼（如把“校验 token 是否过期并刷新”简化为“检查 token”）
- 生成的 JSDoc 字段顺序错乱（
@returns写在@param前面）
建议流程：AI 生成初稿 → 快速扫读关键字段 → 手动调整参数类型、返回值描述、中文语义准确性 → 用 koroFileHeader 统一格式收尾。省略校验环节，等于把注释可信度交给模型随机发挥。
