sublime text 不能直接运行 docker 容器，本质是调用宿主机 docker 命令挂载文件进容器执行；关键依赖本地 docker 就绪、路径映射正确、变量在 cmd 数组中及时展开，常见错误包括 path 未继承、docker daemon 未连接、单引号内 sublime 变量不生效。
docker 命令，把当前文件或项目目录挂载进容器执行。成败关键不在 Sublime 配置多精细，而在本地 Docker 是否就绪、路径是否映射对、变量是否被提前展开。
为什么 docker run 在 Sublime 构建系统里总报错？
常见错误不是语法写错，而是环境没打通：
• docker: command not found：Sublime 启动时没继承 shell 的 $PATH，尤其 macOS GUI 启动时 PATH 常为空；解决办法是用完整路径，比如 /usr/local/bin/docker，或在构建系统中显式设置 "path": "/usr/local/bin:/opt/homebrew/bin"
• Cannot connect to the Docker daemon：Docker Desktop 没启动，或 Linux 上用户没加 docker 组；Mac 用户注意：重启 Docker Desktop 后要重新从终端启动 Sublime（open -a "Sublime Text"），否则 PATH 和 socket 连接仍不可见
• 挂载后容器内找不到文件：因为 ${file_path} 是 Sublime 变量，只在 cmd 数组中生效；若你用了 shell_cmd 并写了单引号包裹的字符串，${file_path} 就不会被替换——必须用数组形式 + sh -c 外壳，且变量放在单引号外
sublime-build 文件里怎么写 docker run 才能正确挂载和执行？
别直接拼 docker run -v ${file_path}:/src ...——这是错的。Sublime 的 cmd 是数组，不经过 shell，&&、;、管道全无效。正确写法是用 sh -c 包一层，同时控制变量展开时机：
• 正确示例（Python）：["sh", "-c", "docker run --rm -v '${file_path}:/workspace:ro' -w /workspace python:3.11 python ${file_name}"]
• 关键点：
– 整个 sh -c 命令用一个字符串传入，所以外层用双引号，内部路径用单引号防止宿主机 shell 提前解析
– ${file_path} 和 ${file_name} 在 Sublime 解析 cmd 数组时就被替换成真实路径，因此必须放在单引号外面
– 容器内工作目录 -w 要和挂载路径匹配，否则 python ${file_name} 会找不到文件
• 如果需要编译再运行（如 C++），把命令链放进第二层 sh -c：["sh", "-c", "docker run --rm -v '${file_path}:/workspace:ro' -w /workspace gcc:11 sh -c 'g++ -o a.out ${file_name} && ./a.out'"]
使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。
用 docker build + run 时为什么总重建镜像？
构建系统每次执行都走完整流程，不会复用 layer 缓存，也不识别 .dockerignore。这不是 Sublime 的问题，而是构建方式决定的：
• 直接写 "shell_cmd": "docker build -t tmp . && docker run --rm tmp"：每次都会触发全新构建，哪怕只改了一行代码
• 更实用的做法是分离构建与运行：先用独立命令构建一次（比如在终端跑 docker build -t myapp .），然后构建系统只负责 docker run；或者把构建逻辑写进脚本，由 Sublime 调用脚本而非裸命docker
• 如果项目有 Dockerfile 且想一键构建+运行，建议用 working_dir 指向项目根，并确保 docker build 命令里的上下文路径（.）和 COPY 指令目标一致；否则 COPY ./src /app 可能因相对路径错位而失败
• 注意 file_regex 字段无法捕获 docker build 的多行错误输出，它只匹配单行格式如 main.cpp:5:10: error:；复杂构建日志建议切到终端看
能不能在 Sublime 里看到容器的实时日志或交互式输出？
不能。Sublime 的构建系统是单次执行、无 TTY、不保持连接的进程模型：
• docker run -it 会被忽略 -t（分配伪终端），-i（保持 stdin）也无效，因为构建系统不转发输入流
• 日志是 stdout/stderr 的一次性快照，滚动到底就结束，不支持 docker logs -f 那种持续流
• 真正需要交互（比如 Python REPL、Node.js debugger、数据库 CLI），得换工具：Terminus 插件可开嵌入式终端，手动执行 docker exec -it container-name bash；或者用 VS Code + Dev Containers
• 若坚持用 Sublime，唯一折中方案是把日志重定向到文件，再用 Sublime 打开该文件（但无法自动刷新）
