Ctrl+/仅注释当前行，需确认语言模式、光标位置及无插件冲突；中文乱码需设utf8编码、启用autoGuessEncoding、配置中文字体；推荐koroFileHeader生成中文函数注释；块注释用Shift+Alt+A并整行选择。
Ctrl+/ 注释失效？先确认语言模式和光标位置
VSCode 的 Ctrl+/（Windows/Linux）或 Cmd+/（macOS）默认只对「当前光标所在行」起作用，不是对选中区域整体注释。常见现象是：鼠标拖选 5 行后按快捷键，结果只有第一行加了 //。
真正生效的前提有三个：
- 右下角状态栏显示的语言模式必须是
javascript、typescript、python等明确支持该注释符号的语言，不能是Plain Text或未识别类型 - 光标需落在有效代码行（如函数声明、变量赋值），不能在空行或注释块中间
- 没有插件劫持快捷键（比如 Vim 扩展、Auto Close Tag 可能屏蔽原生行为）
验证方式：按 Ctrl+Shift+P 输入 Developer: Inspect Editor Tokens and Scopes，看 languageId 是否为预期值。
中文注释乱码？关键在文件编码和字体设置
中文注释显示为方块或问号，90% 是编码或字体问题，和语言包无关。
必须检查三项：
-
files.encoding设置为utf8（不是utf-8，VSCode 配置里写的是utf8） - 启用
files.autoGuessEncoding，让 VSCode 自动识别旧文件的编码（如 GBK） -
editor.fontFamily中包含中文字体，例如"Microsoft YaHei", "SimSun", "Consolas"；纯英文字体（如 Fira Code）不渲染中文
注意：改完设置后，已打开的文件不会自动重载编码，需手动点击右下角编码标识 → 选择 Reopen with Encoding → UTF-8。
自动生成中文函数注释？别用 Document This，换 koroFileHeader
Document This 插件对中文支持差：不识别解构参数（如 ({ id, name }) => {}），也不处理箭头函数表达式体（如 const fn = () => "ok"），更无法生成带中文字段描述的 JSDoc。
koroFileHeader 是目前最稳的选择，它不依赖语言服务，靠模板驱动，配置简单：
- 安装插件后，在
settings.json中添加如下片段（注意双引号转义）：
"fileheader.customMade": {
"Description": "实现 $1 功能",
"Author": "meishaonv",
"Date": "Do not edit this line",
"LastEditTime": "Do not edit this line"
}
- 按
Ctrl+Alt+T（默认快捷键）即可在函数上方插入中文注释块 - 它会自动提取函数名、参数名，并支持中文变量名（如
用户ID、订单状态）
若想适配 TypeScript 解构参数，需手动补全字段注释——这点所有插件都做不到全自动，语义理解仍需人工介入。
多行注释快捷键不生效？别用鼠标框选，改用行选择
Shift+Alt+A（Windows/Linux）或 Shift+Option+A（macOS）是块注释快捷键，但它只对「文本选区」生效，且不同语言包裹方式不同：/* */（JS/TS）、''' '''（Python）、<!-- -->（HTML）。
容易踩坑的操作：
- 用鼠标拖选代码 → 快捷键只包裹首行末尾和末行开头，缩进错乱
- 在 JSX 内部（如
<div>{ /* */ }</div>）误用 JS 注释，应使用 HTML 风格注释 - 文件后缀识别错误：比如
.tsx被识别为typescript而非typescriptreact，导致 JSX 区域无法触发{/* */}
正确做法：点击行号左侧空白处（整行高亮），或按 Shift+Alt+↓ 多选数行，再按 Shift+Alt+A —— 这样才能稳定包裹成块注释。
复杂点在于：同一个文件可能混合多种语言（如 .tsx 同时含 TS 逻辑与 JSX 模板），注释行为由光标所在语言层决定，不是全局统一的。这点常被忽略，但直接影响你每天敲多少次退格键去修格式。
