插件ID和命令名不能用中文，因为VSCode底层依赖字符串哈希匹配，中文会导致解析失败或注册无效；中文仅允许用于displayName、title、description等展示层字段，且须UTF-8编码。
VSCode插件开发中，中文命名本身不被支持——package.json 的 contributes.commands.command、activationEvents、contributes.configuration.properties 等字段必须使用合法的 JSON key，而 JSON key 不允许含中文字符（会直接导致解析失败或命令注册无效）。
为什么插件 ID 和命令名不能用中文？
VSCode 插件系统底层基于 Node.js 模块加载和事件分发机制，所有命令 ID、激活事件、配置项路径都作为字符串参与哈希匹配和路由查找。一旦出现中文字符：
-
vscode.commands.registerCommand('my-ext.搜索文件', ...)→ 报错Error: command 'my-ext.搜索文件' not found -
"activationEvents": ["onCommand:打开设置"]→ 插件根本不会被激活 -
"my-plugin.配置项"在vscode.workspace.getConfiguration()中无法被正确读取
中文只允许出现在哪些地方？
中文可安全用于不影响运行逻辑的「展示层」字段，但需注意编码与平台兼容性：
-
package.json中的displayName、description、categories字段：支持 UTF-8，但发布到 Marketplace 前建议用英文主文案 + 中文副文案（避免搜索降权） - 命令的
title字段（即命令面板里显示的文字）：{ "command": "my-ext.toggle", "title": "切换开关" }✅ 合法且推荐 - 配置项的
title和description（在 Settings UI 中显示）："my-ext.enable": { "type": "boolean", "title": "启用自动补全", "description": "开启后将实时提示代码片段" } - 所有字符串值必须保存为 UTF-8 编码，避免用记事本另存为时选错编码（Windows 上尤其容易生成 GBK 文件，导致乱码）
如何兼顾中文用户友好和工程健壮性？
核心原则：运行时用英文 ID，展示时用中文文案。常见错误是把两者混用，比如在 registerCommand 里传中文 ID，再幻想它能被命令面板识别。
- 命令 ID 命名统一用小写+连字符：
my-extension.open-dashboard，不是my-extension.打开面板 - 对应
package.json的contributes.commands必须完全一致："command": "my-extension.open-dashboard" - 在
package.json中为该命令配中文title："title": "打开控制台面板"，用户看到的是中文，VSCode 内部仍按英文 ID 调度 - 配置项 key 全英文，但
title/description可双语并列（用换行或括号分隔），例如："title": "自动保存间隔（毫秒）\nAuto Save Interval (ms)"
真正容易被忽略的是：插件发布后，VS Code Marketplace 的搜索完全依赖 displayName 和 description 的英文关键词。哪怕你把所有 UI 文案都写成中文，海外用户也搜不到你的插件——这不是技术限制，而是生态事实。
