vscode项目级插件管理核心是按需、隔离、可复现：eslint等语义强绑定插件须工作区控制，vscode-icons等ui类插件适合用户级安装；通过.vscode/extensions.json声明推荐插件id并配合settings.json配置行为，实现环境统一与协作一致。
VSCode 插件不是装得越多越好，项目级插件管理的核心是「按需、隔离、可复现」——装错路径、混用全局/工作区配置、忽略依赖声明，都会导致协作时“在我电脑上是好的”这类问题。
如何判断一个插件该装在用户级还是工作区级
关键看插件是否与项目语义强绑定。比如 ESLint、Prettier、uni-create-view 这类需要读取项目根目录下 .eslintrc.js、prettier.config.js 或 pages.json 的插件，必须由工作区控制；而 vscode-icons、Chinese (Simplified) Language Pack 这类纯 UI/本地化插件，适合用户级安装。
容易踩的坑：
- 把
Live Server装成用户级后，在某些 monorepo 子项目里无法识别public/入口路径 - 用
code --extensions-dir指定自定义路径却没同步进团队文档，新人拉代码后插件不生效 - 误将
cpptools配置写进用户 settings.json，结果 C++ 项目切换工具链时编译路径报错
用 settings.json + extensions.json 实现插件声明式管理
VSCode 支持在工作区根目录建 .vscode/extensions.json，显式列出必需插件 ID（不是名称），这样新成员打开项目时编辑器会弹出“推荐插件”提示。
示例 .vscode/extensions.json：
{
"recommendations": [
"ms-python.python",
"esbenp.prettier-vscode",
"dbaeumer.vscode-eslint",
"dcloudio.uni-app"
]
}
配合 .vscode/settings.json 中的插件专属配置（如 "editor.formatOnSave": true），才能让插件行为真正项目化。否则即使装了 Prettier，没开 formatOnSave 也等于没用。
插件路径冲突：为什么重装 VSCode 后扩展全没了
因为默认插件路径绑定了当前系统用户目录（Windows 是 %USERPROFILE%\.vscode\extensions，macOS/Linux 是 ~/.vscode/extensions）。重装系统或换账号后，这个路径就丢了。
解决思路不是备份整个 extensions 文件夹（版本杂乱难维护），而是：
- 对团队项目，用
.vscode/extensions.json+ CI 脚本自动安装（code --install-extension ms-python.python） - 对自己常用工具链，把插件 ID 写进 shell alias 或 setup script，比如
alias vssetup='code --install-extension ...' - 绝对不要手动移动插件文件夹——VSCode 启动时只扫描完整命名格式为
publisher-name.extension-name-version的子目录，改名或剪切粘贴会导致加载失败
Live Server 和 uni-app 插件共存时的端口与路由陷阱
Live Server 默认占 :5500，而 uni-app 的 H5 模式开发服务器默认走 :8080。表面不冲突，但实际运行时可能因代理配置或浏览器缓存导致资源 404。
真实问题往往藏在细节里：
-
Live Server的liveServer.settings.root如果设成"./"，而项目里又有uni-app的dist/dev/h5/目录，它会错误地把index.html当作根入口，跳过manifest.json配置 -
uni-create-view生成页面后，若pages.json路径写错（比如多了一层src/），Live Server打开的仍是空白页，但控制台无任何报错提示 - 调试时发现 CSS 生效但 JS 不执行，大概率是
Live Server的 MIME 类型没正确识别.js，需检查其设置里的liveServer.settings.AdvanceCustomBrowserCmdLine是否被意外覆盖
最常被忽略的一点：插件之间没有天然的协同机制。哪怕都装上了，ESLint 不会主动告诉 Prettier “我刚修好了分号”，uni-create-view 也不会等 Live Server 就绪再刷新——所有联动逻辑，必须靠你明确配置或脚本串联。
