拖拽.vsix没反应？先确认vscode已启动并获焦点、文件为原始未解压.vsix、路径无中文或空格；cli安装需先注册code命令、用绝对路径并加英文双引号；版本不匹配需升级vscode或换低版本插件；装上但不生效则需手动启用并绑定语言模式。
拖拽 .vsix 到编辑区没反应？先确认这三件事
VSCode 离线装汇编语法高亮插件（比如 13xforever.language-assembly-x86 或 asf1994.assembly）失败，90% 是卡在基础前提上：
- VSCode 必须已启动且获得系统焦点：点击编辑器任意空白处，确保任务栏图标高亮
- 不能处于全屏、RDP、TeamViewer 或多显示器缩放偏移状态（这些会静默拦截拖放事件）
- 拖进去的必须是原始未解压的
.vsix文件：用unzip -l asm.vsix验证顶层是否含extension/目录；重命名成asm.vsix.zip会被 Windows 自动解压，VSCode 就直接忽略
code --install-extension 报错？路径和 CLI 是唯一变量
命令行方式更稳定，但对路径和环境零容忍：
- 先运行
code --version，如果报command not found: code，说明 CLI 未注册：在 VSCode 中按Ctrl+Shift+P输入Shell Command: Install 'code' command in PATH并执行 - 路径必须是绝对路径：Linux/macOS 写
code --install-extension /home/user/ext/13xforever.language-assembly-x86-2.0.0.vsix；Windows 推荐正斜杠写法code --install-extension C:/ext/asf1994.assembly-1.4.2.vsix - 路径含空格或中文？必须加英文双引号：
code --install-extension "/mnt/内网/asm-ext/13xforever.language-assembly-x86-2.0.0.vsix" - 报错
Extension is not compatible with Code？说明你本地 VSCode 版本低于插件package.json中"engines": {"vscode": "^1.85.0"}的要求，需升级 VSCode 或换低版本插件
装上了但 .asm 文件没高亮？不是没装好，是没启用或没触发语言关联
很多汇编插件（如 asf1994.assembly）安装后默认禁用，且不自动绑定文件后缀：
- 打开 VSCode 的扩展面板，找到该插件，手动点「启用」按钮；或重启 VSCode（重启会强制刷新启用状态）
- 检查当前打开的
.asm文件右下角状态栏：若显示“Plain Text”，说明语言模式未识别，点击它 → 选择“Assembly (x86)”或对应语言项 - 如果没有该选项，说明插件没正确注册语言贡献：打开
View → Output，切换到Log (Extension Host)，搜索activate或插件 ID，看是否有Failed to activate日志
企业策略禁用扩展？只能手动解压进 extensions 目录
当 GUI 和 CLI 都被组策略封锁（常见于金融、军工内网），就得硬解包：
- 用
unzip -l asf1994.assembly-1.4.2.vsix查顶层目录名，例如输出首行为asf1994.assembly-1.4.2/extension.js，那目录名就是asf1994.assembly-1.4.2 - 解压整个包：
unzip asf1994.assembly-1.4.2.vsix -d /tmp/asm-ext，然后把/tmp/asm-ext/asf1994.assembly-1.4.2整个文件夹复制到：- Windows：
%USERPROFILE%\AppData\Roaming\Code\Extensions\ - macOS/Linux：
$HOME/.vscode/extensions/
- Windows：
- 复制完必须彻底退出 VSCode（包括右下角托盘进程），否则缓存不刷新，新插件不会加载
真正麻烦的从来不是下载或复制，而是语言模式没绑定、LSP 不触发、或者策略锁死了所有入口——这些地方一漏，插件就“存在但不可见”。
