sublime text 默认不识别 dockerfile 文件名，需安装 dockerfile syntax highlighting 插件并手动配置扩展名匹配（如 dockerfile.*、dockerfile）和缩进为 4 空格，否则语法高亮失效。
Sublime Text 默认不识别 Dockerfile 文件名，必须装插件 + 手动关联语法，否则打开就是纯文本，FROM、RUN、COPY 全部不着色——这不是你写错了，是 Sublime 根本没加载 Docker 语法定义。
安装 Dockerfile Syntax Highlighting 插件
这是最核心一步。Sublime 自带语法列表里压根没有 Dockerfile 选项，光靠手动切换语法（View → Syntax）也选不到，因为没这个语法包。
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac）调出命令面板 - 输入
Package Control: Install Package回车 - 搜
Dockerfile Syntax Highlighting（作者 austinhappel，GitHub star 最多、持续维护）并安装 - 安装后重启 Sublime，或手动执行一次
PackageResourceViewer: Open Resource触发初始化（部分环境需要）
装完再打开 Dockerfile，右下角状态栏应显示 Dockerfile，且指令关键词开始高亮。如果还是 Plain Text，说明插件没装成功或被其他插件拦截。
让 Dockerfile.dev 等变体文件自动高亮
默认只认 Dockerfile（首字母大写、无后缀），Dockerfile.prod、Dockerfile.ci、dockerfile（全小写）全被忽略——哪怕内容一模一样，也不会触发语法高亮。
- 菜单栏 Preferences → Settings – Syntax Specific
- 在右侧用户设置中添加：
{ "extensions": ["Dockerfile", "Dockerfile.*", "dockerfile"] } -
Dockerfile.*在 Sublime 里实际只支持简单 glob 匹配，稳妥起见可明确列出："Dockerfile.dev", "Dockerfile.prod", "Dockerfile.ci" - 保存后，所有匹配的文件会自动应用
Dockerfile语法；右键文件标签 →Open all with current extension as…也能临时补救
注意：.dockerfile（带点前缀）是旧版非标准写法，容易和 .dockerignore 混淆，不建议用。
高亮正常但缩进错乱或关键字漏着色
常见现象：状态栏显示 Dockerfile，但 FROM 是白色、# 注释不是绿色，或者多行 ENV 后续内容突然失色——大概率是缩进或插件冲突导致上下文解析失败。
- 确认缩进：底部状态栏应显示
Tab Width: 4和Spaces（不是Tab）；Dockerfile 推荐用 4 空格，不是 tab - 手动修复：View → Indentation → Convert Indentation to Spaces，再设 Tab Width 为 4
- 检查插件冲突：某些插件（如
ApplySyntax、Enhanced Dockerfile）会劫持语法检测逻辑；临时禁用所有插件（Preferences → Package Settings → Package Control → Settings – User，加"installed_packages": []），重启验证 - 别指望靠文件首行注释触发语法，比如
# syntax: docker在 Sublime 里完全无效
镜像名（如 nginx:alpine）、路径（如 /app）默认不着色——这不是 bug，是语法定义本身的设计限制，原生不支持 scope 细分。
格式化 Dockerfile 需要额外工具
语法高亮 ≠ 格式化。Dockerfile Syntax Highlighting 插件只负责着色，不提供排版、换行、指令对齐等能力。真要格式化，得靠外部工具。
- 先全局安装
dockerfile-fmt：npm install -g dockerfile-fmt（需 Node.js） - Tools → Build System → New Build System…，填入：
{ "cmd": ["dockerfile-fmt", "-i", "$file"], "selector": "source.dockerfile", "working_dir": "$file_path", "shell": true } - 保存为
DockerfileFormatter.sublime-build，之后按Ctrl+B即可原地格式化 - 注意权限和路径：确保
dockerfile-fmt在系统 PATH 中，且 Sublime 能调用到；macOS 上可能需配置 shell 环境变量
真正容易被忽略的是：Sublime 的语法绑定依赖精确的文件名或扩展名匹配，而不是内容；一旦用了 Dockerfile.test 这类命名，又没在 extensions 里显式声明，高亮就彻底失效——连报错提示都没有，只会安静地当纯文本处理。
