VSCode插件常忽略中文变量名，因多数插件（如ESLint、Document This）默认按英文标识符规则匹配，未启用Unicode支持，导致无法解析“用户列表”等中文名；JavaScript引擎虽允许，但TypeScript、Babel等工具链普遍不支持，故需插件明确声明兼容或改用koroFileHeader等模板驱动方案。
为什么中文变量名在插件里常被忽略？
VSCode 插件本身不解析语义，只处理 AST 或文本结构；大多数插件（如 Document This、ESLint）默认按英文标识符规则匹配，遇到 用户列表、获取数据 这类中文变量名时，直接跳过或报错 Invalid identifier。
这不是 bug，是设计使然：JavaScript 引擎允许中文变量名，但工具链（TypeScript 编译器、Babel、JSDoc 解析器）普遍未开启 Unicode 标识符支持，导致插件无法安全提取参数名、类型、描述。
- 检查你用的插件是否声明支持
unicode-regex或明确写“支持中文变量”——多数没写=不支持 - 若坚持用中文变量，
koroFileHeader是少数能绕过语言服务、纯模板驱动的插件，它靠正则匹配函数定义行，不依赖 AST - 在
settings.json中加"javascript.preferences.includePackageJsonAutoImports": "auto"没用，这和中文变量无关，别白调
中文注释生成失败的三个硬性前提
按 /** 回车没反应？不是插件坏了，而是 VSCode 的 JSDoc 触发机制卡在三个条件上：
- 当前文件右下角语言模式必须是
javascript、typescript或python—— 如果显示Plain Text或空白，Ctrl+Shift+P→Change Language Mode手动设对 - 光标必须严格落在函数声明行（如
function getUser(id) {）或其正上方空行；在函数体内、注释块中间、箭头函数表达式体（const fn = () => {}）里都不触发 - Python 场景下，
python.docstringGenerator.style必须设为google、numpy或restructuredtext之一，否则"""回车无效
koroFileHeader 配置中文模板的关键细节
它不依赖语言服务，靠字符串模板 + 变量替换，所以对中文最友好，但有几个坑必须避开：
-
"fileheader.customMade"里字段名可以写中文（如"功能说明"），但变量占位符仍得用英文（$description$），否则插件无法注入内容 -
"annotationStr"的head/middle/end值要和你代码里实际注释符号一致：TypeScript 用/** */就设"head": "/**"、"end": "*/"；JSX 文件混用//注释就全配成// - 函数注释快捷键
Ctrl+Alt+T只识别形参名，如果写的是解构参数({ id, name })，它会漏掉字段——这时手动补@param更可靠
插件开发中如何让中文变量被正确识别
如果你自己写插件，想让中文变量参与自动补全、跳转、重命名，核心不是改 UI，而是改语言服务器配置：
- 在
package.json的contributes.languages里确保"id"和 VSCode 内置语言 ID 一致（如"javascript"），否则自定义语法高亮不生效 - 若用 TypeScript 开发插件，
tsconfig.json中加"compilerOptions": { "target": "ES2020", "lib": ["ES2020", "DOM"] }，避免旧 target 导致 Unicode 字符解析异常 - 不要在插件里硬编码正则去匹配变量名，改用
vscode.languages.setTextDocumentLanguage+vscode.languages.getLanguages()动态适配语言模式
中文变量名在编辑器底层是合法的，但工具链默认关着门；打开它需要明确告诉每个环节“这是有效标识符”，而不是指望插件自动猜。
