插件安装失败主因是三个路径不通：用户数据目录（如~/.config/Code）、扩展安装目录（如~/.vscode/extensions）、市场服务URL（https://marketplace.visualstudio.com）；需确保权限可写、路径存在且网络可达。
插件安装失败：先看这3个路径是否通畅
插件根本装不上，大概率不是网络或插件本身的问题，而是 VSCode 找不到能写入的位置。核心就三点：用户数据目录、扩展安装目录、市场服务 URL。
-
~/.config/Code（Linux）或%APPDATA%\Code（Windows）必须可读写——权限被锁死或磁盘满时，extensions子目录压根建不出来 - 如果手动配置过
"extensions.installDir"，务必确认该路径存在且当前用户有写权限；否则所有安装操作静默失败，界面不报错但.vscode/extensions里空空如也 -
https://marketplace.visualstudio.com必须能通——企业内网常拦截此域名，用curl -v https://marketplace.visualstudio.com/vscode测试，若超时或返回 403，就得配http.proxy或关掉代理
插件装上了却不加载：检查 extensions 目录结构和激活逻辑
灰色图标、命令报 command not found、控制台刷 Cannot find module 'vscode-languageclient'，说明插件已解压但没跑起来。问题往往藏在路径和依赖里。
- 进入
~/.vscode/extensions，确认插件文件夹名是publisher.name-version格式（如ms-python.python-2024.12.1），名字错乱或含非法字符会导致扫描失败 - 每个插件目录下必须有
package.json，且其中main字段指向的入口文件（如./out/extension.js）真实存在——离线安装 .vsix 后若没解压完整，out/目录可能缺失 - 语言服务器类插件（如 Python、Rust）依赖
vscode-languageclient等包，这些模块由 VSCode 在插件启动时动态注入；若插件目录里有node_modules，反而会干扰加载，应删掉
想换插件存储位置：用 --extensions-dir，别碰 settings.json
把插件挪到 D 盘或 NAS 上，唯一可靠的方式是启动参数，而不是改配置项。后者已被弃用且极易出错。
- 正确做法：终端执行
code --extensions-dir "/mnt/data/vscode-ext"（Linux/macOS）或code --extensions-dir "D:\vscode-ext"（Windows）——VSCode 会完全忽略默认路径，只认这个目录 - 错误做法：在
settings.json里写"extensions.installDir"——VSCode 2023 年后已不再读取该字段，设了也无效，还会让人误以为配置生效 - 快捷方式建议：Windows 可新建快捷方式，目标栏填
"C:\Users\XXX\AppData\Local\Programs\Microsoft VS Code\Code.exe" --extensions-dir "D:\vscode-ext"；macOS/Linux 建 alias 或修改桌面启动器
@ 路径跳转失效：不是插件问题，是项目级路径映射没对齐
Path Intellisense 或其他路径补全插件“不工作”，90% 是因为 jsconfig.json 或 tsconfig.json 的 paths 配置和实际项目结构不匹配，或者 VSCode 没读到它。
- 配置文件必须放在项目根目录（即打开的文件夹最顶层），不是
src/或packages/下——VSCode 只从工作区根开始向上查找jsconfig.json -
"@/*": ["src/*"]中的星号不能漏，写成"@/": ["src/"]只能匹配@/index.js，无法匹配@/utils/helper.js - 改完配置后必须重启 VSCode 或执行
Developer: Reload Window，缓存不刷新，插件永远读不到新规则
