VSCode离线插件安装失败主因是图形界面依赖网络校验、命令行报错可精准定位；需关闭所有进程、CLI注册、路径加引号、版本匹配及语言服务器离线部署。
VSCode插件安装失败：离线环境下必须用code --install-extension
图形界面点“Install from VSIX”在断网或权限受限时大概率静默失败，不是操作错了，而是扩展面板依赖后台网络校验签名和解压流程。命令行方式能直接报错，比如Extension is not compatible with Code或ENOENT，方便定位。
- 先关闭所有 VSCode 进程（Windows 可执行
code --status确认） - 路径含空格时，Windows 必须用双引号包裹：
code --install-extension "D:\vsix\ms-python.python-2024.6.0.vsix" - macOS/Linux 直接使用绝对路径：
code --install-extension /Users/me/vsix/prettier-9.10.0.vsix - 若提示
command not found: code，说明 CLI 未注册：按Ctrl+Shift+P输入Shell Command: Install 'code' command in PATH并执行
Python环境不生效：解释器路径、虚拟环境识别与终端激活三者必须对齐
VSCode 不会自动把 Python 脚本扔进你选的虚拟环境里跑，它只在终端启动时注入激活逻辑。如果状态栏显示版本但代码仍报ModuleNotFoundError，问题往往出在三者脱节。
- 检查
settings.json中是否显式设置了python.defaultInterpreterPath，路径必须指向venv/bin/python（macOS/Linux）或venv\Scripts\python.exe（Windows） - 确保虚拟环境目录名是
.venv、venv、env或ENV之一，否则 VSCode 不会自动识别 - 打开集成终端后，执行
which python（macOS/Linux）或where python（Windows），确认输出路径与设置一致 - 若终端未自动激活，检查
python.terminal.activateEnvironment是否为true
ESLint自动修复不触发：editor.codeActionsOnSave开关没开，或本地 ESLint 没被正确加载
装了插件 ≠ 自动修复。VSCode 默认不调用eslint --fix，除非你明确告诉它“保存时干这事”，且它得能找到项目里的eslint可执行文件。
- 必须启用
editor.codeActionsOnSave中的source.fixAll.eslint，配置项写法："source.fixAll.eslint": true - VSCode 默认优先用全局
eslint，但项目通常装本地版。需在设置中指定eslint.packageManager为npm或pnpm，并确认package.json存在且已运行npm install - 右下角 ESLint 图标点开，若显示
Using globally installed ESLint，说明没走本地，重启窗口或手动执行Developer: Reload Window - 配置文件优先用
.eslintrc.js，eslint.config.js在多工作区下易漏读；若坚持用新格式，需在eslint.options中显式指定configFile
Q# 或量子插件报QDK not found：.NET SDK 架构和版本不匹配是主因
这不是插件坏了，而是底层运行时根本没准备好。QDK v0.29+ 强制要求.NET 6.0 SDK x64，仅装运行时或 x86 版本都会失败，且错误常静默。
- 运行
dotnet --list-sdks，确认输出含类似6.0.400 [/usr/share/dotnet/sdk/6.0.400/]的条目，且不含x86字样 - 若缺失，必须下载安装
.NET 6.0 SDK x64（不是 Runtime），地址：https://dotnet.microsoft.com/download/dotnet/6.0 - 检查 VSCode 工作区是否标记为
Trusted（右下角状态栏），否则语言服务器拒绝启动 - 确认
qsharp.enableLanguageServer设为true，重启后按Ctrl+Shift+P执行Q#: Restart Language Server
环境检测真正难的不是查哪一项，而是判断哪几项之间产生了隐性耦合——比如 Python 插件依赖 Prettier 格式化能力，而 Prettier 又依赖editor.formatOnSave总开关；又比如 Q# 插件看似独立，实则卡在 .NET SDK 和工作区信任状态两个毫不相干的环节上。这些链路一旦断开，错误信息往往不指向真实根因。
