最准的当前生效插件路径是通过“developer: show extensions folder”命令查看，或运行code --status获取extensions path行；它受--extensions-dir参数、环境变量等覆盖，非文档默认路径。
VSCode 插件路径不是固定死的，它可被覆盖、可被重定向、可被调试器直接读取——但绝大多数人只用默认路径，结果在离线部署、多环境隔离或插件热调试时卡住。
如何确认当前生效的插件路径？
别信文档写的“默认路径”，VSCode 实际加载的是启动时解析出的 --extensions-dir 路径，它可能被命令行、环境变量或快捷方式覆盖。
- 打开 VSCode → 按
Ctrl+Shift+P（macOS 为Cmd+Shift+P）→ 输入并执行Developer: Show Extensions Folder，这是最准的实时路径 - 终端中运行
code --status，输出里会明确列出Extensions Path:行 - 如果用脚本启动 VSCode，检查是否带了
--extensions-dir /xxx参数；Windows 快捷方式的“目标”字段也常被悄悄修改过 - 注意：用户级路径（
~/.vscode/extensions）和系统级路径（如 Windows 的%PROGRAMFILES%\Microsoft VS Code\resources\app\extensions）是两套机制，后者只含内置扩展，不可写
为什么 code --extensions-dir 启动后插件不生效？
常见错因不是路径错了，而是 VSCode 没有真正从该目录加载——它仍会 fallback 到用户默认路径，除非你强制禁用旧路径。
- 必须配合
--disable-extensions使用，否则 VSCode 会同时加载两个路径下的插件，冲突或覆盖难排查 - 路径需存在且有读写权限；若路径为空，VSCode 不会自动创建，也不会报错，只是静默跳过
- macOS/Linux 下路径不能含空格或中文，Windows 下反斜杠
\需转义或改用正斜杠/，否则code --extensions-dir "C:\my ext"会失败 - 重启 VSCode 后，新路径才生效；已打开的窗口不会动态切换扩展目录
调试自定义插件时，为何改了 package.json 却没反应？
因为 VSCode 加载插件时只认 package.json 中的 main 字段指向的入口文件，而这个文件通常在 out/ 或 dist/ 目录下——你改的源码没编译，自然不生效。
- 确保执行了构建命令：
npm run compile（TypeScript）或npm run build（JavaScript），检查out/extension.js是否更新 - 开发时推荐启用 watch 模式：
npm run watch，避免每次手动编译 - 如果用了
vsce package打包再安装，VSCode 会解压到extensions/下的新子目录，旧版本残留会导致双版本共存，建议先卸载再装 - 调试窗口（F5 启动的 Extension Development Host）只加载当前工作区插件，不读取全局
extensions/目录，这点常被忽略
离线环境部署插件，解压 .vsix 后为什么插件不显示？
.vsix 本质是 zip 包，但直接解压到 extensions/ 下不一定能用——目录名必须严格匹配插件 ID 和版本号格式，否则 VSCode 根本不识别。
- 正确做法：用
vsce unpack xxx.vsix解包，它会生成标准命名的文件夹（如ms-python.python-2024.12.1），再复制进去 - 手动解压后，务必检查子目录内是否存在有效的
package.json，且其中name字段非空、main字段路径可访问 - Windows 下若插件路径含长文件名或特殊字符（如
❤️），NTFS 限制可能导致读取失败，建议用短英文名 - Linux/macOS 注意文件权限：
extensions/目录及子目录需对当前用户可读，否则启动时报EPERM错误但无明确提示
路径映射真正的复杂点不在“怎么设”，而在“谁在什么时候读哪个路径”——VSCode 启动流程里，命令行参数、环境变量、用户设置、工作区配置层层叠加，任一环节覆盖都会让路径行为偏离预期。动手前，先跑一遍 code --status 看真实加载路径，比翻文档快十倍。
