VSCode版本低于插件要求时静默不加载插件，因engines.vscode声明版本高于自身而跳过；需核对code --version与package.json中vscode字段，解决方法为降级插件或升级VSCode。
VSCode版本低于插件要求时拖.vsivx直接静默失败
不是插件坏了，是VSCode压根不加载——它会跳过所有engines.vscode声明版本高于自身的插件，连错误提示都不给。打开.vsix解压后的package.json，找"engines": {"vscode": "^1.85.0"}这一行；再运行code --version，取输出中前两位（如1.82.2→1.82），若小于1.85，就注定失败。
解决办法只有两个：
– 降级插件：去该插件的GitHub Releases页翻历史版本，找ms-python.python-2023.8.0.vsix这类带旧版号的包，重点核对它的package.json里vscode字段是否≤你本地版本；
– 升级VSCode：从官网下载匹配架构（x64/arm64）的旧稳定版安装包（如1.85.2），别用最新版——新版反而可能砍掉对老插件的支持。
code --install-extension在旧版VSCode里报INVALID_SIGNATURE
VSCode 1.70之前默认启用微软证书链校验，离线环境无法连接证书服务器，就会卡在签名验证并报INVALID_SIGNATURE。这不是文件损坏，是网络不可达导致的策略拦截。
必须加--allow-unverified参数绕过：
– Windows：code --install-extension C:/ext/python.vsix --allow-unverified
– Linux/macOS：code --install-extension /home/user/ext/prettier.vsix --allow-unverified
注意：这个参数在VSCode 1.80+已弃用，只对旧版有效；若提示参数不识别，说明你的VSCode其实已经太新，问题出在别处。
手动复制extensions目录时路径和结构必须严丝合缝
旧版VSCode（尤其是1.60–1.75区间）对扩展目录名敏感，不允许任何重命名或嵌套层级变动。比如ms-python.python-2023.8.0这个文件夹名，必须原样出现在%USERPROFILE%\AppData\Roaming\Code\Extensions\（Windows）或$HOME/.vscode/extensions/（macOS/Linux）下，少一个点、多一个下划线都不行。
操作要点：
– 先在联网机上用VSCode正常装一次目标插件，再进extensions/目录把整个对应文件夹打包带走；
– 不要用unzip -d解压.vsix后手动复制内容，必须复制整个未解压的文件夹；
– 替换前务必彻底退出VSCode，包括右下角系统托盘里的进程，否则旧缓存会锁死新目录。
ARM Mac上给旧版VSCode装x64插件，功能缺失但不报错
旧版VSCode（如1.72）在ARM Mac上运行x64插件时，不会弹窗警告，也不会在Developer: Show Running Extensions里标红，而是静默跳过native二进制部分——比如Python插件的pyright-server根本起不来，只剩基础语法高亮。
确认方法：
– 运行code --version看Help → About里显示的架构（arm64还是x64）；
– 解压.vsix，检查package.json里是否有"engines": {"vscode": ">=1.70.0"}, "browser": false, "platforms": ["darwin-arm64"]这类字段；
– 若没有darwin-arm64，哪怕插件页面写着“支持Mac”，对ARM Mac旧版VSCode也无效。
