Based on Sublime Text与Docker-Compose容器调试-sublime-PHP中文网

sublime text 无法直接调试 docker-compose 容器，因其不具备容器调试能力，不监听端口、不注入调试器、也不解析 docker-compose.yml 配置；调试需依赖外部工具链配合，如 docker exec 进入容器手动调试或用宿主机工具测试连通性。

based on sublime text与docker-compose容器调试

Sublime Text 为什么不能直接调试 docker-compose 容器

它压根没有容器调试能力——既不监听容器端口、也不注入调试器、更不会解析 docker-compose.yml 中的 ports 或 environment 配置来自动建立调试通道。所谓“调试”，在 Sublime 里只能靠外部工具链配合实现，比如用 docker exec -it 进入容器手动运行 python -m pdb，或靠宿主机上的 curl/telnet 测试服务连通性。

怎么让 Ctrl+B 触发 docker-compose up 并定位错误行

关键不是命令写对，而是 Sublime 能否把终端输出里的文件路径+行号提取出来跳转。否则构建失败只能手动翻日志。

新建 Build System：Preferences → Build Settings → New Build System

填入以下内容（注意 file_regex 必须严格匹配 Docker Compose 的报错格式）：

{
  "shell_cmd": "sh -c "cd ${project_path:} && docker-compose up --build --force-recreate"",
  "file_regex": "^(.+?):([0-9]+):([0-9]+):\s*(error|warning)",
  "working_dir": "${project_path:}",
  "variants": [
    {
      "name": "Build Only",
      "shell_cmd": "sh -c "cd ${project_path:} && docker-compose build""
    }
  ]
}

file_regex 仅对 docker-compose config 或某些校验插件（如 hadolint）有效；docker-compose up 自身错误（如端口占用、镜像拉取失败）不带行号，file_regex 会失效
若用 docker-compose.yml 变体（如 docker-compose.prod.yml），需在命令中显式加 -f docker-compose.prod.yml，否则默认只读 docker-compose.yml

docker-compose.yml 文件始终显示 Plain Text 怎么办

这不是文件写错了，是 Sublime 根本没加载语法定义。它只认扩展名，不靠内容推断语言。

Docker Ctl

使用 podman 检查容器、日志和镜像

下载

装插件：用 Package Control 安装 YAML（作者 bradleybossard），别装已弃用的 YAML Language
手动绑定：打开 docker-compose.yml → 点右下角 Plain Text → Open all with current extension as… → 选 YAML (Docker Compose)（如果插件提供了该选项）
若无专属选项，进 Preferences → Settings – Syntax Specific，右侧加：
```
{"extensions": ["docker-compose.yml", "docker-compose.yaml"]}
```
避免粗暴全局映射：不要选 Open all with current extension as… → YAML，否则所有 .yml（如 logback.yml）都会强制用 YAML 语法，可能破坏其他插件行为

想进容器终端调试，但 Remote - SSH 不生效

Remote - SSH 插件连接的是 SSH 服务，不是 Docker 守护进程。你得先确保容器里跑着 sshd，且端口映射正确——这和本地开发习惯冲突大，容易踩坑。

最简替代：用 Terminus 插件开终端，执行 docker ps 查容器 ID，再运行 docker exec -it <container_id> /bin/sh</container_id>
若坚持用 Remote - SSH，容器必须预装 openssh-server，并暴露 22 端口（docker run -p 2222:22），还要配好密钥认证
SFTP 插件同步文件时，remote_path 必须指向容器挂载的目录（如 /app），且启动容器时用 -v 挂载同一路径，否则改了本地文件，容器里看不到
调试 Python/Node.js 等服务，依赖端口映射（ports:）+ 宿主机工具（如浏览器、curl、postman），Sublime 本身不参与调试协议