VSCode离线安装失败常因系统盘空间不足导致写入失败，而非网络或版本问题；磁盘满时VSCode静默卡在“Installing…”或跳过安装，需用df -h（Linux/macOS）或资源管理器检查C盘及~/.vscode/extensions所在分区剩余空间。
VSCode 插件默认全塞在系统盘用户目录下，离线安装失败往往不是因为网络或版本，而是磁盘空间耗尽后写入失败——它不报错，只卡在“Installing…”或静默跳过。
为什么插件装到一半就消失或没反应
系统盘（尤其是 Windows 的 C:\Users\{user}\.vscode\extensions 或 Linux 的 ~/.vscode/extensions）空间不足时，VSCode 无法完成解压、签名校验、文件写入三步操作。它不会弹窗提示“磁盘满”，而是让进度条停住、扩展列表里不出现、甚至已显示“已安装”但重启后失效。
- 检查方式：
df -h（Linux/macOS）或资源管理器查看 C 盘剩余空间；若~/.vscode/extensions所在分区剩余 - 真实现象：执行
code --install-extension xxx.vsix后无输出、无错误，但ls -l ~/.vscode/extensions/看不到对应文件夹 - Windows 用户特别注意：AppData 是隐藏目录，
%USERPROFILE%\AppData\Roaming\Code下的 extensions 可能占掉数 GB，且被杀毒软件频繁扫描，进一步拖慢写入
用 VSCODE_EXTENSIONS 环境变量彻底换盘安装
这是唯一能绕过系统盘限制、且对所有启动方式（快捷方式、命令行、右键菜单）都生效的方法。改完不用重装 VSCode，也不影响现有配置。
- Windows：新建「系统环境变量」，变量名
VSCODE_EXTENSIONS，变量值填你目标路径，比如D:\vscode-ext（不要填 VSCode 安装目录下的子文件夹，会冲突） - macOS/Linux：在
~/.zshrc或~/.bashrc末尾加一行export VSCODE_EXTENSIONS="/path/to/your/ext"，然后运行source ~/.zshrc - 必须彻底退出 VSCode（包括右下角托盘进程），再重新打开——否则旧插件仍从原路径加载，新插件也仍写进 C 盘
迁移旧插件不能剪切，必须复制+验证
环境变量生效后，新插件会自动落到新路径，但旧插件还在原处。直接剪切过去会导致 VSCode 启动时找不到扩展，报一堆“Extension not found”警告。
- 安全做法：把原
~/.vscode/extensions（或 Windows 对应路径）下所有文件夹，完整复制 到新VSCODE_EXTENSIONS目录下 - 复制完别急着开 VSCode，先确认新路径下有对应文件夹，且权限正常：
ls -ld /path/to/your/ext应显示当前用户可读写 - 首次启动后，进设置搜索
extensions.autoUpdate，关掉自动更新——避免某次联网后又往 C 盘写临时文件
别信 --extensions-dir 参数能一劳永逸
这个参数只对「当前终端那一次启动」有效。双击桌面图标、从开始菜单打开、用右键菜单“Open with Code”，全都不认它。
- 常见翻车现场：在终端输
code --extensions-dir "D:\ext"成功装了几个插件，第二天点图标打开，发现全没了 - Mac 用户额外注意：用 Launchpad 或 Dock 启动时，
--extensions-dir完全无效，必须靠VSCODE_EXTENSIONS - 如果非要临时用参数，Windows 快捷方式右键 → 属性 → “目标”末尾加空格 +
--extensions-dir "D:\ext"（英文引号不可少）
最易被忽略的是：改完环境变量后没杀干净托盘进程，或者复制旧插件时漏了某个带 native 二进制的文件夹（比如 ms-python.python-2024.6.0 里的 out/ 和 dist/），结果 Python 插件能看见但调试器起不来——这不是安装失败，是路径迁移不完整。
