重命名.vsix文件必须用复制而非右键重命名，否则会损坏ZIP头导致安装静默失败；正确做法是PowerShell的Copy-Item或Linux/macOS的cp命令，并校验完整性。
重命名 .vsix 文件必须用复制，不能右键“重命名”
Windows 上直接右键 → 重命名 .zip 改成 .vsix，会导致文件头损坏，VSCode 安装时静默失败——它不是简单改后缀，而是 ZIP 包需保留原始结构和签名头。
正确做法是用 PowerShell 复制生成新文件：
Copy-Item "old.zip" "python-20260811.vsix" -Force- 或用 7-Zip / Archive Utility 解压再重新打包（不推荐，易出错）
- Linux/macOS 下可用
cp old.zip python-20260811.vsix，但务必先用unzip -t python-20260811.vsix校验完整性，输出OK才算有效
重命名要带日期或用途，别只留版本号
下载的文件名常为 Microsoft.VisualStudio.Services.VSIXPackage 或 ms-python.python-2026.8.1.vsix，这类名字在多个插件混放时极易混淆，尤其离线环境无法查来源。
建议统一按 {插件名}-{日期}.vsix 或 {插件名}-{用途}-{日期}.vsix 命名：
python-20261027.vsixrust-analyzer-offline-20261027.vsixhighlight-words-for-code-server.vsix
避免用空格、中文、特殊符号；. 和 - 是安全分隔符。
重命名后安装失败？先检查 package.json 里的 vscode 版本兼容性
重命名本身不影响功能，但很多人重命名后 code --install-extension 报错“不兼容”，其实是 package.json 中的 engines.vscode 字段和当前 VS Code 版本不匹配。
快速验证方法：
- 用 7-Zip 或
unzip -p your.vsix extension/package.json | grep engines - 确认输出类似
"vscode": "^1.85.0"，再运行code --version对比 - 若 VS Code 是 1.84，而插件要求 >=1.85，就得换低版本 vsix 或升级编辑器
某些插件根本没上架 Marketplace，重命名前得先确认来源是否可靠
比如 rust-lang.rust-analyzer 在官网 Marketplace 没“Download VSIX”按钮，右键无反应——它不走标准发布流程，得去 GitHub Releases 下载。
这种情况下，你拿到的压缩包可能不是标准 .vsix 结构：
- 解压后没有
extension/package.json→ 不是合法 vsix，不能直接code --install-extension - 文件名含
setup或server→ 往往是 LSP 二进制，需手动配置"rust-analyzer.serverPath" - GitHub Release 页面下载的
.vsix可能未同步最新版，务必核对package.json中的version和engines.vscode
真正关键的不是文件叫什么，而是它能否被 VSCode 识别为扩展包：根目录下必须有 extension/ 子目录，且内含有效的 package.json。
