vscode中/**回车不生成doxygen注释，主因是语言模式错误、光标位置不当或插件配置不匹配；需确认语言为c/cpp/js、光标在函数声明行上方，并正确配置doxdocgen或korofileheader等插件参数。
为什么 /** 回车没生成 Doxygen 注释？
不是插件没装，而是 VSCode 的 /** 触发机制只对特定语言生效，且有严格位置要求。常见失效原因包括：
- 当前文件右下角语言模式显示为
Plain Text或未识别类型——点击它手动切换成c、cpp或javascript - 光标不在函数定义行（如
int foo(int a);）或其正上方空行，而是在函数体内或已有注释中间 - C/C++ 场景下用了
Doxygen Documentation Generator，但配置项doxdocgen.c.triggerSequence被误改成了///或其他值 - JavaScript/TypeScript 中启用了
Document This，但它不解析箭头函数表达式体（如const fn = () => {}）和解构参数（如({ id, name }) => {}）
Doxygen Documentation Generator 的关键配置项
这个插件是 C/C++ 项目最稳的 Doxygen 注释生成工具，但默认配置不够贴合中文团队习惯。必须手动调整以下几项：
-
doxdocgen.c.firstLine：设为"/**"（不能漏掉引号），否则触发失败 -
doxdocgen.c.lastLine：设为" */"（注意开头空格），保证闭合格式统一 -
doxdocgen.c.commentPrefix：设为" * "（星号+空格），避免生成***或缩进错位 -
doxdocgen.c.fileOrder：控制文件头字段顺序，例如["@file", "@brief", "@author", "@date"]，中文作者名可直接写进@author值里 -
doxdocgen.cpp.ctorText和doxdocgen.c.getterText这类智能文本字段，若想用中文，直接填"创建一个 {name} 对象"即可，插件支持 UTF-8
koroFileHeader 怎么配出 Doxygen 风格注释？
它不依赖语言服务，适合需要跨语言统一风格的场景，但模板变量名必须是英文（如 $description$），值可以写中文。要生成类似 Doxygen 的 @param 结构，得这样配：
{
"fileheader.customMade": {
"Author": "李四",
"Date": "Do not edit",
"Description": ""
},
"fileheader.configObj": {
"autoAdd": true,
"annotationStr": {
"head": "/**",
"middle": " * ",
"end": " */"
},
"functionTemplate": {
"before": "",
"after": "",
"params": [
" * @param {$1} {$2} - ",
" * @returns {$3} "
]
}
}
}
-
annotationStr.head和.end决定注释块起止符，必须匹配 Doxygen 解析器要求 -
functionTemplate.params数组里每项对应一个参数占位，$1是参数名，$2是类型（需手动补），$3是返回值类型 - 若项目用 C++ 模板函数，
functionTemplate无法自动推导template<typename t></typename>，得靠人工加一行* @tparam T
用户代码片段（Snippets）生成 Doxygen 注释的边界在哪？
Snippets 最轻量、最可控，但本质是纯文本替换，不读取 AST，所以没有参数自动提取能力。适合固定结构，比如文件头或标准函数签名：
- 在
cpp.json里加一个prefix为dh的片段，body写成：["/**", " * @file ${TM_FILENAME}", " * @brief ${1:功能简述}", " * @author ${TM_AUTHOR}", " * @date ${CURRENT_YEAR}-${CURRENT_MONTH}-${CURRENT_DATE}", " */", "${0}"] -
${TM_AUTHOR}必须提前在 VSCode 设置中通过files.author填好，否则留空 - 无法为
void process(std::vector<int>& arr, const std::string& msg)</int>自动生成两个@param行——得靠插件（如Doxygen Documentation Generator或koroFileHeader）来解析函数签名 - 如果团队里有人用 macOS、有人用 Windows，
${CURRENT_HOUR}:${CURRENT_MINUTE}会因系统时区设置不同而出现时间偏差，建议只用日期部分
真正难的不是生成注释，而是让注释持续准确。函数签名一改，所有 @param 就可能过期；@brief 写成“处理数据”等于没写。模板再自动，也绕不开人对语义的理解。
