vscode插件管理关键在精准识别与配置：插件文件夹名须严格匹配publisher-name.extension-name-version格式，package.json中运行时字段必须英文小写连字符，配置优先级为工作区>用户>默认，多项目需防插件越界加载。
VSCode 插件管理不是靠“装得多”，而是靠“认得清、改得准、删得稳”。盲目重命名插件文件夹、混用中英文 ID、在错误作用域改配置，三分钟就能让插件集体失活。
为什么插件文件夹名不能手动改
VSCode 启动时扫描 ~/.vscode/extensions（macOS/Linux）或 C:\Users\{用户名}\.vscode\extensions（Windows）下的每个子目录，按固定格式解析：publisher-name.extension-name-version（如 ms-python.python-2024.12.1）。一旦你把它改成 python-2024 或加中文，VSCode 就跳过该目录——不报错、不提示，只是安静地忽略。
- 插件 ID 和文件夹名必须严格一致，否则
activationEvents不触发，命令注册失败 -
Developer: Show Extensions Folder是唯一可靠路径定位方式，别靠资源管理器地址栏手输 - 想备份？直接复制整个
extensions文件夹即可；想迁移？解压新插件到同路径，重启 VSCode 自动识别
package.json 里哪些字段能写中文
运行时字段（contributes.commands.command、activationEvents、contributes.configuration.properties）必须全英文小写+连字符，比如 my-extension.toggle-panel。写成 my-extension.切换面板 会导致：
Error: command 'my-extension.切换面板' not found- 配置项
my-extension.自动保存在vscode.workspace.getConfiguration()中返回undefined - 插件根本不会被激活，
onCommand:类事件全部失效
但展示层字段安全支持 UTF-8 中文：
-
displayName、description：可写中文，但 Marketplace 搜索权重低，建议英文主文案 + 中文副文案 -
contributes.commands.title：命令面板显示文字，如"title": "打开控制台面板"✅ -
contributes.configuration.properties.*.title和.description：Settings UI 中显示，支持换行分隔中英文
扩展设置该写在哪一级
VSCode 扩展设置有明确优先级：工作区 .vscode/settings.json > 用户 settings.json > 插件默认值。改错层级=白改。
- Prettier 只对前端项目生效？必须写进项目根目录的
.vscode/settings.json，而不是全局设置 - ESLint 规则想跨项目复用？把公共规则抽成
eslint-config-myorg，再在各项目.vscode/settings.json中通过"eslint.options": { "configFile": "./node_modules/eslint-config-myorg/index.js" }引入 - 在插件页点齿轮 → “Extension Settings” 时，右上角标的是
User还是Workspace，决定了配置写进哪个文件
monorepo 下插件怎么不越界加载
pnpm workspace 或 Turborepo 项目里，Project Manager、Workspace Config 这类插件会扫描整个工作区找 package.json，把每个子包当独立项目加载——结果就是 packages/ui 里跑 packages/api 的 ESLint 规则，报一堆 Cannot find module '@api/utils'。
- 禁用所有带
tree、outline、structure字样的第三方侧边栏插件，原生 Explorer 足够用 - 确保
jsconfig.json或tsconfig.json中的"paths"配置存在，否则Path Intellisense补全别名路径会失效 - Volar/Vetur 必须启用，且
typescript.tsdk指向项目本地node_modules/typescript，否则类型检查走的是 VSCode 内置 TS 版本
最常被忽略的点：插件是否真的需要？很多所谓“结构管理”插件，本质是在掩盖配置缺失——比如没配 paths 却指望图标插件帮你猜路径，不如花两分钟补好 jsconfig.json。
