离线安装 red hat yaml 插件需同时复制含预编译 yaml-language-server 的完整扩展文件夹，仅拖入 .vsix 无效；必须确认插件 id 为 redhat.vscode-yaml、vscode ≥1.80.0、拖放时窗口有焦点且为原始 .vsix 文件。
离线安装 Red Hat YAML 插件（redhat.vscode-yaml）完全可行，但只拖入 .vsix 文件不等于能用——它依赖语言服务器（yaml-language-server），而该服务默认首次启用时联网下载。离线环境下必须提前准备带二进制的完整包，或手动补全。
确认插件 ID 和正确版本
Red Hat YAML 插件的唯一 ID 是 redhat.vscode-yaml，不是 “yaml” “yaml support” 等模糊名称。在有网机器上务必从官方市场下载最新稳定版：https://www.php.cn/link/ebf76e113d5506e0b532903328160b3a。点击右侧 Download Extension 得到 redhat.vscode-yaml-1.19.0.vsix 类似文件（版本号随时间更新）。别用 GitHub 源码编译版——它不含预编译的 yaml-language-server 二进制，离线无法运行。
拖拽安装失败？先检查三个硬条件
把 .vsix 拖进 VSCode 主编辑区没反应，大概率卡在这三点：
- VSCode 窗口没系统焦点（任务栏图标未高亮），需主动点击窗口使其获得输入焦点
- 拖的是已解压的文件夹，或 ZIP 改名的假
.vsix；必须是原始未解压的.vsix（可用unzip -l redhat.vscode-yaml-1.19.0.vsix确认顶层含extension/目录） - VSCode 版本低于插件要求：检查插件
package.json中"engines": {"vscode": "^1.80.0"}，你的 VSCode 运行code --version确认 ≥ 1.80.0
全屏模式、远程桌面（RDP/TeamViewer）会拦截拖放事件，退出后再试。
装上了但没高亮/补全？语言服务器根本没启动
这是离线环境最典型的“静默失效”：
- 安装
.vsix只注册了前端 UI，yaml-language-server二进制需首次启用时下载——离线就卡在状态栏显示Downloading yaml-language-server... - 正确做法：在有网机器上，用同一版本 VSCode 打开任意
.yaml文件，等待状态栏出现Ready，此时服务已落地到~/.vscode/extensions/redhat.vscode-yaml-1.19.0/node_modules/yaml-language-server/下 - 把整个
redhat.vscode-yaml-1.19.0/文件夹（含node_modules和其中的bin/可执行文件）复制到内网机对应extensions/目录 - 复制完必须彻底退出 VSCode（包括右下角托盘进程），再重新打开，否则缓存不刷新
验证是否真生效，别信扩展面板显示
扩展面板显示“已启用”不等于功能就绪：
- 打开一个
deploy.yaml，左下角语言模式必须是YAML（不是 Plain Text）；若不是，点击左下角 →Configure File Association for '.yaml'→ 选YAML - 输入
apiVersion:，应立刻弹出apps/v1、batch/v1等建议；没有则说明语言服务器未加载 - 故意写错字段如
kind: Podd，应实时标红并提示Value is not accepted. Valid values: "Pod"
真正麻烦的从来不是安装动作本身，而是语言服务器二进制的落地路径和时机——它藏在 node_modules 深层目录里，且不同平台（darwin-arm64 / win32-x64）不可混用，复制时连同父级文件夹名（redhat.vscode-yaml-1.19.0）一起挪，不能重命名。
