Vagrantfile和Jenkinsfile因无扩展名被Sublime默认识别为纯文本，需手动绑定Ruby或专用Jenkinsfile语法；Jenkinsfile校验可通过Build System配置ssh调用declarative-linter实现一键验证。
为什么Vagrantfile总是Plain Text？
Sublime 默认不把 Vagrantfile 当 Ruby 文件处理，因为它没扩展名，而 Sublime 的语法识别逻辑只靠文件名启发式匹配——Vagrantfile 不在默认白名单里。结果就是 config.vm.network、Vagrant.configure(2) 全是黑底白字，缩进错乱，补全失效。
解决方法只有两个有效路径：
- 手动绑定：打开任意
Vagrantfile→ 点右下角Plain Text→Open all with current extension as…→ 选Ruby（注意不是 Ruby on Rails） - 永久生效：进入
Preferences → Settings – Syntax Specific，在右侧 User 配置中加一行：{"extensions": ["Vagrantfile"]}
注意大小写：vagrantfile（小写）不会被匹配；如果装了多个 Ruby 相关插件（比如 Ruby Slim），可能干扰语法加载，控制台报 Unable to find syntax，建议禁用非必要插件。
Jenkinsfile高亮必须装专用插件
别搜“Jenkins”——官方没维护 Sublime 插件，得用社区版 Sublime-Jenkinsfile（作者 guillermooo，GitHub star 过千）。装完不等于高亮自动生效，还得手动关联语法。
实操步骤：
- Package Control → Install Package → 搜
Jenkinsfile→ 选Sublime-Jenkinsfile，安装后重启 - 打开
Jenkinsfile→ 点右下角语法名 →Open all with current extension as…→ 选Jenkinsfile（不是 Groovy） - 如果
agent被标成变量、stages块颜色异常，大概率是误启用了 Groovy 语法——声明式 Jenkinsfile 结构特殊，必须走专用语法定义
装了插件但右下角仍显示 Plain Text？正常。插件只是提供了语法定义，还没被激活，必须手动触发一次绑定。
Build System一键跑 declarative-linter
本地验证 Jenkinsfile 结构比等 Jenkins 报错快得多，但手动敲 ssh 命令太重复。用 Sublime 的 Build System 绑定，Ctrl+B 就能执行校验并跳转错误行。
配置要点：
- 菜单 →
Tools → Build System → New Build System - 粘贴以下内容并保存为
Jenkinsfile Linter.sublime-build：
{
"cmd": ["ssh", "-p", "8675", "your-jenkins-host", "declarative-linter"],
"shell": true,
"working_dir": "$file_path",
"file_regex": "WorkflowScript: (\d+): (\d+): (.*)"
}务必替换 your-jenkins-host 和端口（默认 SSH 是 22，但很多 Jenkins 生产环境改成了 8675 或其他）；file_regex 中的括号要转义，否则无法正确提取行号。
错误信息列号不准是常态——Groovy 解析器把换行和缩进当字符计数，实际看整行上下文更可靠。
容易被忽略的细节
真正卡住人的从来不是“该装什么”，而是 Sublime 对无扩展名文件的静默处理：它不提醒、不报错、不猜测，就给你纯文本。你得主动干预。
还有几个硬性限制：
-
Vagrantfile首行加# -*- mode: ruby -*-可作为 fallback，但旧版 Sublime 可能不认；# vim: set ft=ruby :更兼容，但得确保空格和星号位置严格匹配 -
Jenkinsfile的environment块里写${VAR}引用未定义变量，declarative-linter不会报错——它只校验结构，不查变量存在性 - 所有语法绑定都依赖准确的路径或文件名；
Preferences.sublime-settings里填错syntax路径（比如大小写错、少个Packages/）不会提示，只会静默失效
