必须先通过“developer: show extensions folder”确认真实extensions目录，再用--extensions-dir指定新路径并剪切旧插件迁移，否则离线安装必败。
确认当前 extensions 目录位置再动手
直接改路径前不确认真实目录，90% 的离线安装会失败。VSCode 不读取设置里的“插件路径”字段，它只认启动时指定的位置或默认硬编码路径。最稳的方式是打开 VSCode，按 Ctrl+Shift+P（macOS 是 Cmd+Shift+P），输入并运行 Developer: Show Extensions Folder —— 它会直接在文件管理器中打开正在使用的目录，而不是你“以为”的路径。
常见误判包括：
- 把
%USERPROFILE%\.vscode\extensions当成 Windows 实际路径，但某些企业镜像版或便携版会指向其他位置 - 在 macOS 上误用
/Applications/Visual Studio Code.app/Contents/Resources/app/extensions（这是内置扩展目录，不是用户扩展存放地） - 没关掉 VSCode 就去移动文件夹，导致进程锁住目录，后续安装报错
EPERM: operation not permitted
用 --extensions-dir 指定新目录（官方唯一推荐方式）
这是 VSCode 官方支持、无副作用、可长期复用的方案。本质是让 VSCode 启动时“换一个地方找插件”，而不是覆盖默认路径。操作分两步：
- 把现有
extensions文件夹整体剪切到目标位置，例如D:\vscode-ext（注意：末尾不能带斜杠） - 用命令行启动：
code --extensions-dir "D:\vscode-ext"（--extensions-dir和路径之间必须有空格，路径必须用英文双引号包裹） - 首次成功后，所有新装插件自动进该目录；旧插件只要放进去，重启 VSCode 就能识别
关键细节：
- 桌面快捷方式要同步改：右键 → 属性 → “目标”末尾追加
--extensions-dir "D:\vscode-ext" - 右键菜单需改注册表（Windows）：
HKEY_CLASSES_ROOT\*\shell\Open with Code\command的默认值，替换为完整带参数的命令 - macOS/Linux 用户可用 alias 或包装脚本，避免每次输长命令
code --install-extension 在离线环境下的实际限制
这个命令看似方便，但在纯离线机器上基本不可用——它依赖 code 命令已注册到 PATH，且默认仍会尝试联网校验签名。常见卡点：
-
command not found: code：不是没装 VSCode，而是没执行过Shell Command: Install 'code' command in PATH（通过Ctrl+Shift+P调出） -
INVALID_SIGNATURE错误：离线环境无法验证微软证书链，必须加--allow-unverified参数，例如：code --install-extension python.vsix --allow-unverified - 装完不显示：插件可能有隐式依赖（比如 Python 插件强依赖
ms-python.pylance），仅装主插件无效；得先查vscode-extensions.txt列表，再逐个补全
手动拷贝 .vsix 到 extensions 目录不会生效
直接把下载好的 python-2024.6.0.vsix 文件丢进 extensions 目录，VSCode 完全无视——它只认解压后的文件夹结构，不是 .vsix 包本身。正确做法只有两个：
- 用图形界面：扩展面板右上角
…→Install from VSIX…→ 选中 .vsix 文件，VSCode 自动解压并重命名文件夹（如ms-python.python-2024.6.0） - 用命令行：
code --install-extension /path/to/python.vsix，同样触发解压和注册流程
绕过这两步，直接扔 .vsix 进目录，等于往图书馆书架上塞压缩包——书没拆封，系统根本找不到内容。
