VSCode本身不支持中文代码格式化，中文变量名会被破坏是因TypeScript/Prettier默认不支持Unicode标识符，导致转义或报错；需禁用相关校验、停用JS/TS格式化、加prettier-ignore注释保字符串，并在非生产环境谨慎使用中文命名。
VSCode 本身不支持“中文代码格式化”——它没有、也不会把中文字符当作语法成分去解析或排版。所谓“中文代码”，实际是注释、字符串字面量、变量名（如 用户名）、或 JSX/HTML 中的中文文本，这些内容在格式化过程中**默认不被修改**，Prettier、ESLint、clang-format 等工具均不处理中文语义。
为什么中文变量名会被格式化“破坏”？
这不是格式化插件主动改中文，而是它按 JS/TS 规范处理标识符时触发的副作用：
-
prettier默认启用parser: "typescript"或"babel"，而 TypeScript 官方不支持 Unicode 标识符（如用户名）作为合法变量名；即使你用allowJs: true或noImplicitAny: false，prettier在输出时仍可能把非 ASCII 标识符转义为\u7528\u6237\u540D或报错 -
eslint的no-unused-vars等规则会因无法识别中文标识符而误报 -
typescript-eslint解析器默认禁用allowDeclareFields和allowUnreachableCode外的 Unicode 支持，中文变量名直接导致ParseError
想保留中文变量名，必须关掉哪些配置？
如果你坚持使用中文命名（例如教学、低门槛项目），需在项目级配置中显式禁用相关校验与转换：
- 在
.eslintrc.js中关闭标识符检查：rules: { "no-undef": "off", "@typescript-eslint/no-unused-vars": "off" } - 在
tsconfig.json中启用宽松解析："compilerOptions": { "allowSyntheticDefaultImports": true, "skipLibCheck": true, "noFallthroughCasesInSwitch": false }（但useDefineForClassFields等仍可能冲突） - 在
.prettierrc中禁止转义：{"escapeHtml": false, "proseWrap": "never"}—— 注意这仅影响 HTML 字符串，对 JS 变量名无效 - 最关键的一步：停用
prettier对 JS/TS 文件的格式化，改用仅处理 HTML/CSS 的语言专属配置："[javascript]": {"editor.defaultFormatter": null}, "[typescript]": {"editor.defaultFormatter": null}
中文注释和字符串怎么保持原样不被“动”？
这部分其实很安全，但容易被忽略的细节是：
-
prettier默认不会修改字符串内容，但若启用了printWidth且字符串超长，它会自动换行并加续行反斜杠（\）——中文字符串换行后可能断在字中间，阅读困难 - 解决方法：在字符串前加
// prettier-ignore注释，或全局设"printWidth": 0（禁用自动折行） - 中文注释缩进对齐靠
editor.formatOnSave+editor.detectIndentation，但若文件混用空格/制表符，VSCode 可能错误缩进中文字符（因为中文占位宽度 ≠ ASCII）；建议统一设"editor.insertSpaces": true和"editor.tabSize": 2 - Vue/JSX 中的中文文本（如
<div>你好世界</div>）会被prettier当作纯文本处理，只要没开htmlWhitespaceSensitivity: "strict"就不会删空格
真正难处理的是混合场景：比如一个 const 用户名 = "张三" 声明，既含中文变量名又含中文字符串。此时没有通用方案能同时满足类型检查、格式化、可读性——你得在「让工具链跑起来」和「坚持中文命名」之间做明确取舍。最务实的做法是：只在原型、教案、或完全不走 CI 的本地小项目里用中文变量名，生产环境一律回归英文命名规范。
