离线更新VSCode插件必须提前在有网环境拉取依赖并同步整个扩展目录；报“not compatible”错误几乎全是engines.vscode版本不匹配导致的静默拒绝，需用code --version核对本地版本是否≥.vsix中package.json声明的最小版本。
离线更新 VSCode 插件不是“点一下更新就行”，而是必须提前在有网环境完成依赖拉取、再同步整个扩展目录；自动重构代码逻辑则完全依赖语言服务器（LSP）就位，Copilot 等 AI 工具只生成文本，不校验语义。
code --install-extension 更新插件为什么总报 not compatible
这个错误几乎全是 engines.vscode 版本不匹配导致的静默拒绝，不是网络或路径问题。
- 先运行
code --version，取输出中第一个小数点前两位（如1.85.2→1.85） - 用
unzip -p your.vsix extension/package.json | grep vscode（Linux/macOS）或 7-Zip 打开查看"vscode": "^1.80.0"字段 - 你本地版本必须 ≥ 这个值；若为
1.72.0而插件要求^1.75.0，安装会失败且不提示具体兼容版本 - ARM Mac 上装了 x64 构建的插件（尤其含 native 二进制的，如
pyright），也会触发同类报错，需找带darwin-arm64标识的版本
拖拽安装后插件显示已启用但 Python 补全/格式化不工作
这是离线环境最典型的“假成功”：插件包装上了，但语言服务器（LSP）没下载下来。
- 像
ms-python.python、esbenp.prettier-vscode这类插件，首次启用时会自动下载pyright或prettierCLI，离线卡在状态栏 “Downloading…” 就是这个原因 - 别重装
.vsix，要提前在有网机器上：打开一个.py文件 → 触发下载 → 等状态栏变绿/无下载提示 → 再去%USERPROFILE%\.vscode\extensions\（Windows）或$HOME/.vscode/extensions/（macOS/Linux）里整个拷贝对应文件夹（如ms-python.python-2024.6.0/） - 手动复制后，必须彻底退出 VSCode（包括右下角托盘进程），否则缓存不刷新
Refactor 菜单为空或只有 Rename Symbol
说明语言服务没加载成功，不是插件没装，而是 LSP 断了。
- 确认右下角语言模式正确（例如显示
TypeScript，不是Plain Text或JavaScript React） - 在
.ts文件中按F12测试能否跳转到定义；跳不到，F2重命名必然失效 - 打开开发者工具（
Ctrl+Shift+P→Developer: Toggle Developer Tools），看 Console 是否报gopls连接失败、Pylance初始化超时等 - Python 项目必须配置好解释器路径，且
python.defaultInterpreterPath指向含pyproject.toml或setup.py的环境
Copilot 提示 “No refactorings available” 怎么办
Copilot 本身不提供语义级重构能力，它只响应提示生成补全文本；这个提示本质是底层 LSP 没就位，不是 Copilot 的问题。
- 确保已安装对应语言的官方扩展（如
ms-python.python、dbaeumer.vscode-eslint），并重启 VSCode 后打开真实项目目录（而非单个文件） -
F2重命名才是唯一安全路径：VSCode 基于 LSP 返回全部引用位置后批量编辑；Copilot 的 “Ask Copilot to suggest a better name” 只提建议，不改调用方 - Extract to function 用 Copilot 辅助时，它常漏参数、错作用域、忽略
this或await绑定——所有外部变量都得你手动加进参数列表
真正难的从来不是“怎么装”，而是搞清哪些东西必须提前在有网机器上跑一遍、哪些路径名必须原样保留、哪些菜单空着其实是在提醒你 LSP 根本没起来。离线环境里，多一次验证比多十次重试更省时间。
