vscode 中文注释失效因语言模式、光标位置及插件限制：jsdoc 需 javascript/typescript/python 模式且光标在函数声明行；python 需配置 docstring 风格；typescript 解构参数和箭头函数体不被 document this 支持；korofileheader 最稳，支持中文模板但占位符须英文；markdown 预览乱码需用 markdown preview enhanced 并配置中文字体；终端调试界面汉化需安装语言包并重启 vscode。
为什么按/**回车没生成中文注释？
不是插件坏了，而是 VSCode 的 JSDoc 触发机制有硬性前提：当前文件右下角语言模式必须是 javascript、typescript 或 python，不能是 Plain Text 或未识别类型；光标必须落在函数声明行（如 function getUser(id) {）或其正上方空行，不能在函数体内、注释块中间或任意空白处。
Python 场景下还需确保 python.docstringGenerator.style 设为 google、numpy 或 restructuredtext 之一，否则 """ 回车无效。TypeScript 中若用 Document This 插件，它不识别解构参数（如 ({ id, name }) => {}）和箭头函数表达式体（如 const fn = () => "ok"），会直接漏掉参数注释。
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）可写成“功能说明”，但变量占位符仍必须用英文（如 $description$），否则插件无法替换内容。
Markdown 写作时中文目录和公式怎么不出乱码？
原生预览不支持 KaTeX 和 Mermaid，导出 PDF 时中文变方块，根本原因是默认字体不含中文字形。解决方案很明确：
- 装
Markdown Preview Enhanced替代原生预览，它支持 LaTeX 公式（$E = mc^2$）、Mermaid 流程图，并允许自定义导出字体 - 导出 PDF 前，在插件设置里填入系统已安装的中文字体名，例如 Windows 填
SimSun或Microsoft YaHei，macOS 填PingFang SC -
Markdown All in One的 TOC 生成命令（Ctrl+Shift+P→Markdown All in One: Create Table of Contents）默认只扫描#~######标题，若文档混用 HTML 标签标题（如<h2></h2>），它不会识别
终端和调试界面还是英文？
VSCode 的终端、调试控制台、输出面板等模块使用独立的语言服务，汉化插件默认不覆盖它们。手动补救方法只有两个：
一是在终端执行：code --install-extension MS-CEINTL.vscode-language-pack-zh-hans 强制刷新语言包依赖；二是打开命令面板（Ctrl+Shift+P），输入 configure display language，确认选中 zh-cn，然后重启 VSCode —— 这步不能跳过，否则配置不生效。
真正容易被忽略的是：即使界面全中文，某些扩展（比如 GitLens 的 hover 提示、Live Server 的启动日志）仍可能沿用英文，这是扩展自身未做国际化导致的，和 VSCode 主体语言无关，只能等作者更新或换用支持中文的替代插件。
