拖拽.vsix无反应，95%因vscode未加载工作区、无系统焦点或文件损坏；需确认已开文件夹、任务栏图标高亮、unzip -l验证extension/package.json存在。
拖拽 .vsix 文件后界面没反应，先确认 VSCode 是否“能收”
VSCode 对拖放操作极其敏感，空白启动、焦点丢失、文件损坏这三类问题占离线安装无响应的 95%。它不报错，只沉默忽略。
- 必须已打开一个文件夹或文件（不能是纯欢迎页），否则拖入直接被丢弃
- 窗口要有系统焦点：任务栏图标高亮，远程桌面（RDP/TeamViewer）或 macOS 多显示器缩放偏移下拖放常失效
- 用
unzip -l your-file.vsix检查顶层结构 —— 第一行必须是extension/package.json；若显示一堆零散文件或报错，说明已被解压或 ZIP 头损坏 - 路径含中文或空格？Windows 下必须用英文双引号包裹完整路径，如
"C:\my ext\ms-ceintl.vscode-language-pack-zh-hans-1.96.3.vsix"
code --install-extension 命令没反应或报 command not found
这不是网络问题，是 CLI 工具根本没注册进 shell 环境。VSCode 官方包（.deb/.rpm/macOS ZIP）默认不配置 code 命令。
- 先运行
which code：无输出即命令不可见 - 临时解决：用绝对路径执行，如 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 - 永久修复：VSCode 内按
Ctrl+Shift+P→ 输入Shell Command: Install 'code' command in PATH→ 回车 → 重启终端 - 切勿加
sudo：否则插件装到 root 用户目录，普通用户启动后不可见
装完重启还是英文？关键不是“装了”，而是 locale.json 是否写对且加载
语言包只是资源库，VSCode 是否启用它，只看 locale.json 文件内容和进程是否干净重启。
- 文件路径必须准确：
Windows：%APPDATA%\Code\User\locale.json
macOS：~/Library/Application Support/Code/User/locale.json
Linux：~/.config/Code/User/locale.json - 内容必须是合法 JSON：
{"locale": "zh-cn"}（小写、短横线、双引号、冒号后有空格）——zh_CN、zh-hans、Chinese全部无效 - 保存为 UTF-8 无 BOM 编码，否则解析失败
- 重启前必须彻底退出：关掉所有窗口 + 杀掉托盘里的
Code Helper进程，否则缓存不刷新
报 not compatible with the current version of VS Code 怎么修
这不是文件损坏，是 package.json 里声明的最低版本超出了你本地 VSCode 的能力。VSCode 只比对主版本号（如 1.96.3 → 1.96），不联网校验。
- 运行
code --version，取前两位数字（如1.96.3→1.96） - 解压
.vsix，打开extension/package.json，找到"engines": {"vsix": "^1.90.0"}这行 - 改成匹配你本地的主版本，如
"vscode": "^1.96.0"或更严格地写成"vscode": "1.96.3" - 重新打包必须用
zip命令或 7-Zip；Windows 资源管理器双击解压再压缩会破坏 ZIP 结构，导致静默失败
locale.json”。很多人改了文件却没杀干净后台进程，或者把文件放到了工作区级路径（.vscode/）而非用户级路径，结果白忙一场。
