code命令不可用是离线安装静默失败的主因，需先用which code或where code验证，再通过Shell Command注册CLI并重启终端；临时可用绝对路径调用，切勿sudo执行以防权限错乱。
code命令不可用导致离线安装静默失败
离线安装插件时用 code --install-extension 报 command not found，不是网络问题，是 CLI 工具根本没注册进系统 PATH。官方 .deb/.rpm 包和 macOS ZIP 版默认不自动配置 code 命令，Windows 安装器也常漏勾“Add to PATH”。
先运行 which code（Linux/macOS）或 where code（Windows），无输出就确认缺失。临时解决可用绝对路径：
- Linux：
/usr/bin/code --install-extension /path/to/xxx.vsix - macOS：
/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code --install-extension /path/to/xxx.vsix - Windows：
"C:\Users\{user}\AppData\Local\Programs\Microsoft VS Code\bin\code.cmd" --install-extension "C:\vsix\plugin.vsix"（注意双引号包裹含空格路径）
永久修复：在 VSCode 里按 Ctrl+Shift+P → 输入 Shell Command: Install 'code' command in PATH → 回车执行，再重启终端。别加 sudo，否则插件会装到 root 用户目录，普通用户启动后看不到。
settings.json 语法错误或路径配置冲突引发静默卡死
VSCode 启动或安装扩展时若读取到损坏的 settings.json，不会报错，而是直接跳过或卡在“Installing…”。常见于手动编辑后逗号遗漏、引号不闭合、或误写无效字段（如拼错 extensions.installDir）。
检查位置：
- Windows：
%APPDATA%\Code\User\settings.json - macOS：
~/Library/Application Support/Code/User/settings.json - Linux：
~/.config/Code/User/settings.json
快速验证方法：
- 启动时加
--disable-extensions参数：如果能正常打开，说明问题出在扩展或其依赖的配置上 - 重命名整个
User文件夹为User.bak，再启动 VSCode —— 它会生成全新配置；确认能用后，再逐段复制旧settings.json内容，并用 jsonlint.com 校验语法 - 特别注意
extensions.installDir字段：若自定义了路径但目录不存在、不可写或权限被锁（如设在/usr/local或C:\Program Files），所有扩展安装都会静默失败
.vsix 文件校验失败却不提示具体原因
拖拽安装卡在 “Installing…” 或弹出 Extension is corrupt / not compatible with the current version of VS Code，多数不是文件损坏，而是 VSCode 在解析 package.json 时因版本或架构不匹配直接拒绝加载。
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
必须做三件事：
- 解压检查结构：
unzip -l plugin.vsix确认顶层有extension/package.json；若只看到零散文件，说明已被解压或下载不完整 - 比对版本：
code --version取前两位（如1.92.2→1.92），再运行unzip -p plugin.vsix extension/package.json | grep engines，看"vscode": "^1.85.0"这类字段 —— 本地版本必须 ≥ 插件要求的最低版本 - 核对架构：Help → About 里看是
x64还是arm64；M 系列 Mac 若装了 x64 构建的 .vsix，必然失败，得去 Marketplace 的versionhistory页面手动选对应平台旧版
别手动改 package.json 里的 engines.vscode，VSCode 启动时会校验签名哈希，改了就真变 corrupt。
扩展目录权限错乱导致写入被拒
曾经用 sudo code 启动过 VSCode，会导致 ~/.vscode/extensions 目录属主变成 root，后续普通用户运行 code --install-extension 就会因 EACCES: permission denied 失败，且错误常被吞掉，只显示“安装完成”但插件不生效。
验证方式：ls -la ~/.vscode/extensions/，若显示 owner 是 root，立刻修复：
- Linux/macOS：
sudo chown -R $USER:$USER ~/.vscode/extensions - Windows：右键
%USERPROFILE%\.vscode\extensions→ 属性 → 安全 → 编辑 → 给当前用户赋予“完全控制”
注意：不要对整个 .vscode 目录递归 chmod 777，这会破坏 VSCode 自身的安全机制，反而触发更多静默拒绝。
离线安装最麻烦的不是找不到文件，而是 VSCode 把关键错误藏在日志里、不报错、不中断、只沉默跳过——所以排查必须从 CLI 命令是否可用、配置文件是否合法、vsix 是否真完整、目录权限是否干净，一层层剥开，不能只盯着“安装失败”四个字打转。
