根本原因是sublime默认不识别docker-compose.yml文件类型，需安装dockerfile syntax highlighting和yaml language support插件，并手动将文件映射为yaml (docker compose)语法；支持变体文件须在syntax specific设置中显式列出完整扩展名如docker-compose.override.yml。
docker-compose.yml 语法高亮不生效，Ctrl+B 没反应
根本原因不是文件写错了，是 Sublime 默认根本不识别 docker-compose.yml 文件类型——右下角显示 Plain Text 就是铁证。它不会根据内容（比如 version: 或 services:）自动切换语法，只靠后缀和手动映射。
必须做两件事：
- 通过
Package Control → Install Package安装Dockerfile Syntax Highlighting（它附带YAML (Docker Compose)专用语法）和YAML Language Support（比自带 YAML 插件更准，支持缩进校验） - 打开一个
docker-compose.yml文件，点右下角Plain Text→Open all with current extension as…→ 找到并选中YAML (Docker Compose) - 若要支持
docker-compose.override.yml等变体，需进入Preferences → Settings – Syntax Specific，在右侧加：{ "extensions": ["docker-compose.yml", "docker-compose.yaml", "docker-compose.override.yml", "docker-compose.prod.yml"] }
注意：docker-compose.*.yml 这种通配写法 Sublime 不认，必须列全名；缩进错一个空格，高亮就会从那行起全部失效，不是 bug，是语法解析器主动放弃。
Ctrl+B 启动服务但容器没起来，或报 command not found: docker-compose
Sublime 的 Build System 本质是调用宿主机 shell，它不继承终端的 PATH，也不检查 Docker daemon 是否运行。常见失败点就三个：
-
docker-compose命令不在系统 PATH 里（尤其 macOS 上用 Homebrew 安装的，路径常是/opt/homebrew/bin）——建议改用docker compose（Docker Desktop 自带，无需额外安装） - Docker daemon 没启动：执行
docker info看是否返回信息，没返回就先开 Docker Desktop 或运行sudo systemctl start docker -
shell_cmd中路径写死但实际项目位置变了：不要硬编码/path/to/your/project，改用 Sublime 变量$project_path，例如："shell_cmd": "cd \"$project_path\" && docker compose up --build -d"
另外，shell_cmd 里单引号会阻止变量展开，必须用双引号包裹整个命令字符串；$project_path 在 Windows 上可能含空格，所以加了 "$project_path" 引号保护。
想看日志却只能新开终端执行 docker compose logs -f
Sublime 的 Build System 设计上就不支持实时流捕获——它启动进程后就认为任务完成，不会持续读取 stdout/stderr。这不是配置问题，是能力边界。
能做的只有两类妥协：
- 开发时用前台启动代替后台：
"shell_cmd": "cd \"$project_path\" && docker compose up --build"，这样日志直接打在 Sublime 的 Build Results 面板里，但终端一关容器全停 - 保留后台启动，另配一个快捷键查日志：新建 Build System，
shell_cmd设为cd "$project_path" && docker compose logs -f，再绑定到 Ctrl+Shift+L（或其他未占用组合键）
别指望一个 Build System 同时做到“启动 + 实时日志 + 自动重连”，Sublime 不是终端复刻器，强行塞功能反而容易卡死面板。
远程服务器上编辑 docker-compose.yml，本地 Ctrl+B 却在本地执行
Sublime 是纯本地客户端，所有构建命令都在你本机跑。如果你编辑的是远程服务器上的文件（比如用 SFTP 插件挂载），但 Build System 还是调用本地 docker，那肯定无效——本地 Docker 里根本没有远程项目的镜像和配置。
真要远程操作，只有两条路：
- 把构建命令改成 SSH 调用：例如
"shell_cmd": "ssh user@host 'cd /remote/path && docker compose up --build -d'"，前提是 SSH 免密且远程 Docker 已就绪 - 用 Terminus 插件开个内嵌终端，手动连远程、cd 到目录、再敲
docker compose up——比 Build System 更可控，也避免 PATH 和环境变量错乱
没有“一键同步+远程执行”的银弹方案。Sublime 的构建系统不处理网络上下文，它只管本地 shell 能不能跑通那条命令。
最常被忽略的其实是 docker compose 和 docker-compose 的版本差异：新 Docker Desktop 默认提供 docker compose（v2），而旧脚本或文档常写 docker-compose（v1）。两者命令参数略有不同，--build 在 v2 里是默认行为，-d 才是必须显式加的。混用会导致静默失败或报错。
