vscode插件路径由启动时的vscode_extensions环境变量优先决定，其次为--extensions-dir参数，最后 fallback 到默认路径%userprofile%.vscode\extensions；环境变量全局生效且覆盖所有启动方式，而命令行参数仅作用于当次进程。
VSCode 插件路径到底由谁决定？
插件安装位置不是由设置界面控制的，而是由启动时的环境变量或命令行参数优先级决定。默认路径只是 fallback —— 一旦 VSCODE_EXTENSIONS 环境变量存在，VS Code 就完全忽略 --extensions-dir 参数和用户目录下的 .vscode/extensions。
常见错误现象：code --extensions-dir /path/to/ext 启动后新装插件仍进 C 盘，是因为你双击图标、用 Dock 或开始菜单打开 VS Code 时根本没带这个参数，它压根没生效。
-
VSCODE_EXTENSIONS是全局生效的唯一可靠方式，所有启动入口（快捷方式、终端、右键菜单）都认它 - Windows 建议设为「系统变量」，避免用户变量在某些权限场景下不被读取
- macOS/Linux 必须把
export VSCODE_EXTENSIONS=...写进~/.zshrc（不是~/.bash_profile，除非你确认 shell 是 bash） - 设完必须彻底退出 VS Code 进程（检查 Activity Monitor / Task Manager），再重新打开
迁移旧插件时最常踩的坑
复制比剪切安全得多 —— 路径没生效时，原目录还能兜底；但剪切后路径失效，插件就直接消失了，连报错都不给。
中文语言包失效不是路径问题，而是加载顺序问题：VS Code 启动时先确定 UI 语言，再加载扩展。如果 ms-ceintl.vscode-language-pack-zh-hans 文件夹没出现在新 VSCODE_EXTENSIONS 目录下，UI 就 fallback 到英文。
- 迁移前先确认新路径下已有该语言包文件夹（名字含
zh-hans或ceintl） - 不要手动改
locale.json里的"locale": "zh-cn"，这只能覆盖 UI，不能解决插件未加载的根本问题 - 用
ls -la $VSCODE_EXTENSIONS（macOS/Linux）或dir %VSCODE_EXTENSIONS%（Windows）验证目录内容是否完整 - 插件名含版本号（如
ms-python.python-2024.6.0），复制整个文件夹，别只拷package.json
为什么 code --extensions-dir 有时像“没反应”？
这个参数只影响「本次进程」，且仅对通过该命令启动的 VS Code 实例有效。它不会修改任何配置文件，也不会影响其他启动方式。
典型误操作：在终端执行一次 code --extensions-dir "/d/ext"，以为“设好了”，结果下次点桌面图标还是走默认路径。
- 快捷方式加参数必须严格格式：
"C:\Users\...\Code.exe" --extensions-dir "D:\vscode-ext"，注意引号前后各一个空格 - macOS 的 Launchpad 启动完全无视命令行参数，必须靠
VSCODE_EXTENSIONS环境变量 - 某些 IDE 插件（如 Remote - SSH）会继承宿主机的环境变量，但容器内需显式挂载或设
ENV VSCODE_EXTENSIONS=... - VS Code Insiders 和 Stable 版本互不共享插件目录，
VSCODE_EXTENSIONS需分别设置
配合内置变量做动态路径配置
${userHome} 和 ${env:HOME} 看似一样，但在 Windows 上行为不同：${userHome} 总是返回用户主目录（如 C:\Users\Alice），而 ${env:HOME} 在 CMD 下可能为空，PowerShell 下才可靠。
如果你在 tasks.json 或 launch.json 里引用插件路径，别硬写绝对路径 —— 可用 ${env:VSCODE_EXTENSIONS} 动态获取当前生效的插件目录。
- 调试时想加载某个插件的本地开发版？可设
"env": { "VSCODE_EXTENSIONS": "${workspaceFolder}/test-extensions" } - CI 流水线中预装插件，建议用
cp -r ./prebuilt-exts/* ${VSCODE_EXTENSIONS}/，而不是依赖code --install-extension -
${pathSeparator}在跨平台脚本中很关键，比如拼接路径时写"${env:VSCODE_EXTENSIONS}${pathSeparator}ms-python.python-2024.6.0"
真正麻烦的从来不是设路径，而是路径生效后插件加载顺序、语言包竞争、Remote 扩展兼容性这些隐性依赖 —— 它们不会报错，只会让你反复重启、怀疑人生。
