必须手动绑定Envoy schema文件并配置yaml.schemas，因VSCode无内置Envoy语言ID，redhat.vscode-yaml插件仅提供通用YAML支持，需将envoy-config-schema.json存入工作区并映射到envoy.yaml等文件路径才能启用字段校验与补全。

VSCode 识别不了 envoy.yaml 是因为没语言绑定

VSCode 默认不支持 Envoy 的 YAML 配置语法高亮或提示，哪怕你打开的是 envoy.yaml 或 bootstrap.yaml，只要没显式告诉它“这是 Envoy 配置”，它就只会当普通 YAML 处理——没有字段校验、没有字段补全、static_resources 和 dynamic_resources 看起来一模一样。

根本原因不是插件缺失，而是 VSCode 没触发任何 Envoy 专属解析逻辑。它连“Envoy”这个语言 ID 都没注册过。

• 装了 YAML 插件（如 Red Hat 的 redhat.vscode-yaml）只提供通用 YAML 支持，不带 Envoy schema
• Envoy 官方不发布 VSCode 扩展，也没有内置语言服务器（LSP）支持
• 所以必须靠手动绑定 + 外部 schema 文件驱动提示

用 redhat.vscode-yaml + 自定义 schema 实现字段提示

真正起作用的是 redhat.vscode-yaml 插件配合 YAML schema 文件。它能根据 JSON Schema 对 key、type、required 字段做校验和补全，而 Envoy 官方恰好提供了完整的 envoy-config-schema.json。

• 安装 redhat.vscode-yaml（必须是 Red Hat 官方版，别选已停更的 yaml-plus）
• 下载最新 schema：访问 https://www.php.cn/link/6b93965f6d3356f54f875107f1f69c4f，找到 envoy-config-schema.json（或用 tools/config_schema/generate_schema.py 本地生成）
• 把 schema 文件存到项目目录下，比如 .vscode/envoy-config-schema.json
• 在工作区 .vscode/settings.json 中加配置：

  {
    "yaml.schemas": {
      "./.vscode/envoy-config-schema.json": ["envoy.yaml", "bootstrap.yaml", "*/envoy/*.yaml"]
    }
  }

  注意路径是相对于 workspace root 的，不是绝对路径；通配符 * 可用，但 ** 不支持

  

  FastAPI Flask Proxy

  FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。

  下载

  为什么 .yaml 文件仍被识别为 YAML 而非 Envoy？

  VSCode 的语言模式识别优先级是：文件后缀 → files.associations → 插件声明。即使绑定了 schema，语言 ID 还是 yaml，不是 envoy——这没问题，因为提示能力来自 schema，不是语言名。

  • 不需要、也不存在 hollowtree.envoy-conf 这类扩展（Envoy 没对应社区维护扩展）
  • 别在 settings.json 里写 "*.yaml": "envoy"，VSCode 根本不认识 envoy 这个 language ID，会直接 fallback 到 plaintext
  • 如果想让右下角显示“Envoy Config”，只能靠自定义语言扩展（需自己写 package.json 注册 envoy language ID），纯属徒增复杂度，无实际收益

  常见错误：提示不生效或报错 “schema not found”

  最常卡在这一步：改完 yaml.schemas 后，保存、重开文件、甚至重启 VSCode，依然没提示。大概率是路径或加载时机问题。

  • yaml.schemas 中的路径必须是相对路径，且文件必须真实存在（VSCode 不会自动创建或远程拉取）
  • 如果 schema 文件放在 ~/.vscode/ 下，它不会被加载——VSCode 只读 workspace 内的 schema
  • 检查 VSCode 输出面板（Ctrl+Shift+U），切换到 YAML 通道，看是否有 Failed to load schema 日志
  • 确保 redhat.vscode-yaml 已启用，并且没被其他 YAML 插件禁用（比如 adamvoss.yaml 冲突）
  • Envoy schema 版本要匹配你用的 Envoy 版本；v1.28 的配置用 v1.25 的 schema 会漏掉新字段（如 typed_extension_protocol_options）

  真正关键的不是“叫 Envoy”，而是让 schema 文件被正确加载并关联到具体文件路径。其余都是干扰项。