离线升级插件失败主因是路径错误、版本不兼容或依赖缺失；参数提示不生效则因语言服务器未加载或设置被禁用，装完插件不等于功能自动启用。
离线升级插件和参数提示不生效，基本是两套独立问题：前者卡在安装路径、版本兼容或依赖缺失；后者卡在语言服务未加载或设置被关。不能指望装完插件参数提示就自动出来。
拖.vsix进VSCode窗口没反应？先确认这三件事
最稳的离线安装方式就是拖文件进主编辑区，但失败几乎都源于前置状态不对：
- VSCode 必须已加载一个工作区（哪怕只是打开一个空文件夹），纯启动页或远程连接未就绪时拖放会被忽略
- 窗口不能全屏，且必须有焦点——Windows 远程桌面或 macOS 屏幕共享常拦截拖放事件，可先点一下编辑区再拖
- 右下角状态栏若显示
Extensions disabled by policy，说明组策略禁用了扩展，GUI 和code --install-extension都会静默失败
code --install-extension 报 “not compatible” 怎么快速定位
这个报错 95% 是版本不匹配，不是网络或权限问题。VSCode 安装时会严格比对 .vsix 包里 extension/package.json 中的 "engines": {"vscode": "^1.80.0"} 字段与本地版本（code --version 输出的第一段，如 1.87.2 → 取 1.87）。
- 用
unzip -l prettier-9.10.3.vsix | grep package.json确认包结构完整，再unzip -p prettier-9.10.3.vsix extension/package.json | grep engines直接看版本声明 - ARM Mac 装了 x64 构建的插件（尤其含 native 二进制的，如
pyright），也会触发同类报错，需找带darwin-arm64标识的版本 - Windows 下路径含空格必须加双引号：
code --install-extension "C:my extprettier.vsix"；反斜杠要转义为C:\my\ext\prettier.vsix或统一用正斜杠C:/my/ext/prettier.vsix
参数提示（Parameter Hints）Ctrl+Shift+Space 没反应？别只调设置
editor.parameterHints.enabled 开了只是前提，真正起作用的是语言服务器（LSP）是否就位。很多离线环境装完 Python 插件却没参数提示，就是因为 pyright 没下载下来。
- 先看右下角状态栏有没有
Python标识，没有就按Ctrl+K Ctrl+M手动设语言模式 - 打开命令面板运行
Developer: Toggle Developer Tools，切到 Console 标签，搜Failed to start language server—— 有就说明 LSP 启动失败 - 输出面板（
View → Output）切换到Python或Pylance通道，如果看到Downloading...卡住或Failed to fetch，说明离线缺 native 依赖，得去有网机器预跑一次再拷整个extensions/ms-python.python-xxxx文件夹过来
装完插件列表显示“已安装”，但功能不生效？重点查这两处
离线场景下，“安装成功”和“可用”之间隔着一层隐藏依赖。尤其语言类插件，首次激活才会拉 LSP 或 CLI 工具。
- 打开命令面板（
Ctrl+Shift+P），输入插件相关命令（如Python: Select Interpreter），能调出才说明核心逻辑加载了 - 检查
~/.vscode/extensions/（Linux/macOS）或%USERPROFILE%.vscodeextensions（Windows）下对应插件目录里有没有node_modules和可执行二进制（如pyright、prettier）—— 如果只有package.json和源码，说明依赖根本没补全 - 某些插件（如 Prettier）需要打开
.js或.ts文件才激活，纯文本或未识别语言类型时不会加载 LSP
