教育网VSCode插件离线安装需确保三要点：窗口获焦点、文件后缀正确、VSCode版本达标；CLI安装须配置PATH并用英文引号包裹路径；Python/Prettier等插件需完整迁移LSP服务目录且匹配ARM架构。
教育网用户常遇到 VSCode 插件无法在线安装的问题，根本原因不是“不能联网”，而是 DNS 解析被劫持、marketplace.visualstudio.com 被限速或拦截、HTTPS 证书校验失败——这些在高校出口网关中极为常见。直接走离线安装是更稳的选择，且无需申请白名单或联系网管。
拖拽 .vsix 到编辑区没反应？先确认这三件事
这是教育网环境下最高频的“假失败”：VSCode 窗口看似开着，实则未获得系统焦点（尤其多显示器+远程桌面共存时）；或浏览器下载的文件被自动重命名为 .vsix.zip；或插件要求 VSCode ≥1.85，而你用的是教务系统预装的 1.72 版本。
- 点击 VSCode 编辑区任意空白处，确保任务栏图标高亮再拖
- 别右键改后缀，用 PowerShell 执行
Copy-Item "python-2024.6.0.vsix.zip" "python-2024.6.0.vsix" -Force - 打开插件详情页，看 Requirements 栏写的最低 VSCode 版本；运行
code --version对比，小数点前两位必须 ≥
code --install-extension 报错 ENOENT 或静默退出？路径和 CLI 是关键
教育网机器常禁用 PATH 写入，code 命令默认不可用；同时，学生机 U 盘路径含中文名、空格极多，不加引号必失败。
- 先在 VSCode 里按
Ctrl+Shift+P输入Shell Command: Install 'code' command in PATH并执行 - Windows 下务必用英文双引号包裹路径：
code --install-extension "D:\我的插件\ms-python.python-2024.6.0.vsix" - Linux/macOS 必须用绝对路径，
~/Downloads这种波浪线写法会失效：code --install-extension /home/student/ext/prettier-9.10.3.vsix
Python / Prettier / Volar 类插件装完没功能？LSP 服务根本没落地
教育网离线安装最隐蔽的坑：插件前端注册成功了，但语言服务器（pyright、prettier CLI、volar-server）首次启用才触发下载。状态栏卡在 Downloading...，输出面板刷满 Failed to fetch，不是网络问题，是根本没东西可下。
- 正确做法：在有网的实验室电脑上，打开一个
.py文件，等状态栏显示Python extension activated后，再复制整个~/.vscode/extensions/ms-python.python-2024.6.0/目录到内网机对应路径 - ARM Mac（M1/M2）学生机务必核对架构：运行
code --version看 Help → About 里是x64还是arm64；下载 vsix 时得选带darwin-arm64后缀的版本，否则 native 二进制部分静默失效 - 复制完必须彻底退出 VSCode：右键托盘图标 → Quit，再重新打开，否则缓存不刷新
真正卡住人的从来不是“装不上”，而是“装上了却不会动”。教育网环境里，版本兼容性、架构匹配、LSP 整目录迁移这三点，漏掉任一环节都会让插件变成摆设。
