VSCode插件离线下载教程_VSCode自动纠正代码命名【秘籍】-VSCode-PHP中文网

离线安装vscode插件必须通过code --install-extension命令或拖入已加载工作区的编辑器主区域触发解压流程，不可直接复制.vsix文件；需确保code命令可用、路径为绝对路径、vsix版本与本地vscode兼容，并在有网环境预先完整初始化语言服务器依赖。

vscode插件离线下载教程_vscode自动纠正代码命名【秘籍】

离线装插件不是“复制粘贴.vsix就完事”，而是必须走code --install-extension触发解压流程；自动纠正命名（F2）也不靠插件，靠语言服务器和项目配置是否就位。

直接双击或拖进空白启动页基本会失败。真正起作用的只有两种方式：命令行安装、或拖进已加载工作区的编辑器主区域（不是侧边栏，不是扩展面板）。

先确认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标识的版本

这是离线环境最典型的“假成功”：VSCode 认为装好了，但语言服务器没拉下来依赖，或者根本没激活。

VSCode

避免常见的 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或拖拽触发的解压流程生成的结构才有效

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 缺口的