离线安装VSCode插件必须通过code --install-extension命令或拖入已加载工作区的编辑器主区域触发解压流程，不可直接复制.vsix文件；需确保code命令可用、路径为绝对路径、vsix版本与本地VSCode兼容，并在有网环境预先完整初始化语言服务器依赖。
离线装插件不是“复制粘贴.vsix就完事”，而是必须走code --install-extension触发解压流程；自动纠正命名（F2）也不靠插件，靠语言服务器和项目配置是否就位。
怎么确保 .vsix 文件真能装进内网 VSCode
直接双击或拖进空白启动页基本会失败。真正起作用的只有两种方式：命令行安装、或拖进已加载工作区的编辑器主区域（不是侧边栏，不是扩展面板）。
- 先确认
code命令可用：code --version能输出版本号；若报command not found，需在 VSCode 里运行Shell Command: Install 'code' command in PATH - 路径必须是绝对路径，Windows 上推荐用正斜杠：
code --install-extension "C:/downloads/python-2024.6.0.vsix" - 报错
Extension is not compatible with Code？立刻解压.vsix（它就是 zip），打开package.json查"engines": {"vscode": "^1.85.0"}，再对比你本地code --version输出的主版本（如1.90.2→ 取1.90） - ARM Mac 装了 x64 版本的
.vsix（尤其含pyright、esbuild等 native 二进制的），也会触发这个报错——得找带darwin-arm64标识的版本
为什么插件列表显示“已安装”，但 Python 补全/重命名还是不生效
这是离线环境最典型的“假成功”：VSCode 认为装好了，但语言服务器没拉下来依赖，或者根本没激活。
- Python 类插件（如
ms-python.python）首次打开.py文件时，会自动下载pyright或python-language-server，离线环境下卡在状态栏“Downloading…”或输出面板报Failed to fetch - 解决办法不是重装
.vsix，而是在有网机器上完整跑一遍：打开一个.py文件 → 等状态栏变绿/输出面板不再刷错误 → 再把整个插件目录（如~/.vscode/extensions/ms-python.python-2024.6.0）原样拷到内网机对应路径 - 别只拷
.vsix文件，也别手动解压后改名放进去——VSCode 不认，必须由code --install-extension或拖拽触发的解压流程生成的结构才有效
F2 重命名只改当前文件？不是插件问题，是配置缺位
VSCode 的 F2 重命名能力来自语言服务器（LSP），不是任何插件提供的。装了 Pylance 或 TypeScript 插件，不代表就能跨文件重命名。
- TypeScript 项目必须有
tsconfig.json，且放在工作区根目录；JavaScript 项目需jsconfig.json（尤其用了paths别名时） - Python 项目要让 Pylance 正确解析模块关系，得有
pyproject.toml或pyrightconfig.json，并声明"include"路径 - 按 F2 前先看右下角：如果显示
Loading Pylance…或TypeScript initializing…，等它完成再试；否则 rename 就是局部的 - 光标停在
obj.name上按 F2，只改属性访问？得双击选中整个name:键名才能同步更新对象字面量里的 key
哪些“自动纠正”真有用，哪些纯属白装
自动修复代码错误（比如补 import、修分号、转var→const）靠的是具体语言服务 + 显式开启开关，不是装个名字带“Auto”“Smart”的插件就行。
- ESLint 插件要生效，必须本地项目装了
eslint包，并在.eslintrc.js里启用可修复规则（如"semi": ["error", "always"]），再配"editor.codeActionsOnSave": {"source.fixAll.eslint": true} - TypeScript 自动补 import 靠
source.organizeImports，但前提是tsconfig.json存在且"compilerOptions.noEmit"设为true或类似基础项已启用 - 名字叫
Auto Refactor、Smart Rename的通用插件，基本只是包装 F2，不会比原生多出任何跨文件分析能力；真正有用的只有ESLint、Prettier、TypeScript Refactoring这类明确补足 LSP 缺口的
离线环境最容易被忽略的点：语言服务器的 native 二进制（如pyright、prettier CLI）不是随.vsix一起打包的，它们在首次启用时才下载——所以“装完即用”在离线场景里根本不存在，必须提前在有网机器上触发一次完整初始化。
