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 时因版本或架构不匹配直接拒绝加载。

Pandas 配置文件报告生成器

使用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 是否真完整、目录权限是否干净，一层层剥开，不能只盯着“安装失败”四个字打转。