VSCode中文代码片段和注释补全需满足UTF-8编码与正确语言模式，否则出现乱码、补全失效或崩溃；中文snippet需注意prefix兼容性、body换行转义及占位符中文转义。
VSCode 原生支持中文代码片段和中文注释补全，但必须满足两个前提：文件编码为 UTF-8，且语言模式（language mode）识别正确。否则中文会显示为乱码、补全不触发、甚至 snippet 插入后崩溃。
为什么中文代码片段插入后变成方块或问号
根本原因是 VSCode 用错误的编码读取了你定义的 snippets.json 或扩展中的中文内容。常见于以下情况：
- 你的
snippets.json文件本身是 GBK 编码保存的（尤其 Windows 上用记事本另存时默认选 GBK），但 VSCode 以 UTF-8 解析 → 中文变 - VSCode 全局设置中
files.encoding被误设为gbk或windows1252，导致所有 JSON/JS/TXT 类型文件强制用错编码打开 - 自定义 snippet 使用了未转义的中文双引号或全角标点，JSON 解析失败，整个 snippet 被跳过（不报错，但也不生效）
验证方式：打开你的 snippets.json，右下角状态栏看当前编码显示 —— 必须是 UTF-8，且点击后选的是 Save with Encoding → UTF-8，不是“Reopen with Encoding”。
中文注释补全（如 /** + Enter）失效的真正原因
这不是插件问题，而是语言服务没把当前文件识别成对应语言，导致注释模板（JSDoc、Doxygen、JavaDoc 等）压根没加载。典型表现：
- 在
.js文件里敲/**回车，没生成参数说明模板 - 在
.py文件里敲"""，没触发 docstring 补全 - 但同一文件里英文注释能正常高亮、折叠 → 说明语法识别 OK，只是注释补全逻辑被绕过了
关键检查点：Ctrl+Shift+P → 输入 Change Language Mode → 确认右下角显示的是 JavaScript，不是 Plain Text 或空值；再确认该文件后缀是否被其他插件劫持（比如某些 Markdown 插件会把 .md 强制设为 markdown，但你实际写的是 Python 脚本）。
手写中文 snippet 时必须注意的三个细节
哪怕编码和语言都对了，中文 snippet 仍可能“看起来能用，实际出 bug”。重点防坑：
-
prefix字段允许中文，但部分键盘输入法在触发时会吞掉第一个字符（尤其搜狗、QQ拼音），建议 prefix 用英文缩写，body里放中文内容 -
body中的中文换行必须用\n，不能直接回车（JSON 不允许裸换行），否则整个 snippet 加载失败 - 如果 body 含有
$1、${2:default}这类占位符，且 default 值是中文，必须用双引号包裹并转义内部双引号，例如："${1:默认值\"带引号\"}"
示例（合法的中文函数注释 snippet）：
{
"函数中文注释": {
"prefix": "zhdoc",
"body": [
"/**",
" * @description $1",
" * @param {$2} $3",
" * @returns {$4}",
" */"
],
"description": "插入中文风格函数注释"
}
}
终端运行时中文注释不乱码，但输出中文仍是问号？
这是最易混淆的点：代码里中文注释是否乱码，和程序运行时 console.log("你好") 是否乱码，是两套独立机制。前者只取决于文件编码与编辑器解析；后者取决于：
- 你的终端（CMD/PowerShell/WSL）当前代码页是否为
65001（即 UTF-8）——Windows 下需在settings.json中配置terminal.integrated.profiles.windows并加chcp 65001 - 运行环境（Node.js / Python / GCC）是否默认使用 UTF-8 输出流，例如 Python 3 在非 Windows 下默认 UTF-8，但显式指定
sys.stdout.reconfigure(encoding='utf-8')更稳妥 - VSCode 的
code-runner或C/C++ Extension的执行命令是否带编码参数（如gcc -o a.exe a.c -finput-charset=utf-8）
一句话：注释能不能写中文，看编辑器；程序能不能输出中文，看终端+运行时+编译器三者是否统一用 UTF-8。两者不联动，别指望改一个就全好。
