Sublime如何配置Docker Compose YAML高亮？（容器编排）

sublime text 默认不识别 docker-compose.yml 文件类型，需手动关联语法或安装 yaml/docker 语法包并配置扩展名。

sublime text 默认不识别 docker-compose.yml 文件类型

Sublime Text 不会自动把 docker-compose.yml 当作 YAML 文件高亮，而是常归为纯文本或“Plain Text”，导致缩进、冒号、列表符号全无颜色区分。根本原因是文件名未被内置语法映射规则覆盖。

解决方式不是装插件，而是手动关联文件名到 YAML 语法：

• 打开任意一个 docker-compose.yml 文件
• 点击右下角当前语法名称（如 Plain Text）→ 选择 Open all with current extension as… → 再选 YAML
• 这会把所有 .yml 文件都设为 YAML 语法——但太粗暴，可能误伤其他非 Docker 的 .yml
• 更稳妥的做法：点击右下角 → Open all with current extension as… → YAML (Docker Compose)（如果已安装对应语法包）

推荐安装 Dockerfile + YAML 增强语法包

单纯靠 Sublime 自带 YAML 支持，对 docker-compose.yml 的关键字（如 services、build、deploy、healthcheck）没有专属着色，也不校验缩进层级是否合法。

用 Package Control 安装两个轻量包即可补足：

• YAML Language Support：比自带 YAML 更准，支持 Schema 校验（需额外配 yaml.schemas）
• Dockerfile Syntax Highlighting：附带的 docker-compose.yml 专用语法，能识别 version 字段值、服务依赖箭头 depends_on、端口映射格式 "8080:80" 等
• 装完后，右下角手动选一次 YAML (Docker Compose)，之后所有 docker-compose*.yml 都会自动匹配

docker-compose.yml 缩进错位时高亮直接失效

YAML 对缩进极其敏感，Sublime 的语法高亮器一旦遇到混用空格/Tab、某行缩进比上一行少但没结束结构，就会从那一行开始全变白色——这不是 bug，是它主动放弃解析。

常见诱因和应对：

• 复制粘贴时带了不可见 Tab 字符 → 用 View → Indentation → Convert Indentation to Spaces
• environment: 下写了 - KEY=VAL 却漏了前面的空格 → 高亮断在 - 行，整块变白
• volumes: 里用了 ./src:/app 这种写法，但冒号前后没空格 → 某些老版语法包会误判为 key:value，建议统一加空格：./src: /app
• 检查缩进是否一致：按 Ctrl+Shift+P → 输入 Set Syntax: YAML 强制重载一次，看是否恢复

想让 docker-compose.override.yml 也高亮？得手动加扩展映射

Sublime 默认只认 .yml 和 .yaml，像 docker-compose.override.yml、docker-compose.prod.yml 这类复合命名不会自动触发语法绑定。

需要编辑用户语法配置文件（路径：Preferences → Browse Packages → User → YAML.sublime-settings），添加：

{   "extensions": [     "yml",     "yaml",     "docker-compose.yml",     "docker-compose.override.yml",     "docker-compose.prod.yml"   ] }

注意：docker-compose.yml 这种带点的字符串必须加引号，否则 json 解析失败；改完不用重启，保存即生效。

这个配置容易被忽略，尤其当你用多环境 compose 文件时，一打开全是灰字，第一反应常以为是插件没装好——其实只是 Sublime 根本没把它当 YAML 处理。