sublime text 默认不识别 jenkinsfile，需安装 sublimejenkins 插件并配置文件关联；安装后设语法为 jenkinsfile，并在 syntax specific 设置中添加 extensions: ["jenkinsfile"] 实现自动识别。
Sublime Text 默认不识别 Jenkinsfile 文件类型
打开 Jenkinsfile 时，Sublime 默认当普通文本或 Groovy 处理，关键词（如 pipeline、agent、stages）没高亮，缩进也容易错乱。这不是插件问题，是文件关联没配对。
- 手动切换语法：右下角点击当前语法名 → 选 Groovy 或 Java 是常见误操作——Groovy 高亮部分关键字，但 Pipeline DSL 特有结构（如
stage块、script步骤）仍无特殊标记 - 正确做法是让 Sublime 把
Jenkinsfile当作专用语法类型处理，而不是依赖通用语言引擎 - 官方 Jenkins 没提供 Sublime 语法包，得靠社区方案补位
安装 Jenkinsfile 专用语法包（Package Control）
用 Package Control 安装 SublimeJenkins 是目前最稳的方案，它专为 Jenkins Pipeline DSL 设计，不是简单套用 Groovy。
- 快捷键
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Package Control: Install Package - 搜索并安装
SublimeJenkins（作者：guillermooo，GitHub 可查） - 安装后重启 Sublime，再打开
Jenkinsfile，右下角应显示Jenkinsfile（不是 Groovy） - 若仍显示 Groovy，右键文件 →
Set Syntax → Jenkinsfile手动指定一次，之后同名文件会自动匹配
确保 Jenkinsfile 被自动识别（避免每次手动设语法）
Sublime 不会默认把无扩展名的 Jenkinsfile 关联到新语法，必须显式配置文件关联规则。
- 菜单栏 →
Preferences → Settings – Syntax Specific - 在右侧窗口添加：
{ "extensions": ["Jenkinsfile"] } - 保存后，所有名为
Jenkinsfile的文件（无论路径、大小写）都会自动用 Jenkinsfile 语法渲染 - 注意：如果文件名是
jenkinsfile（小写）或JenkinsFile，需把"extensions"改成["Jenkinsfile", "jenkinsfile"]，Sublime 匹配不区分大小写但需显式列出
高亮生效但结构折叠/括号匹配异常？检查 Groovy 插件冲突
SublimeJenkins 底层复用 Groovy 解析器，如果同时装了其他 Groovy 插件（如 Gr8Gorilla 或旧版 Groovy），可能抢夺语法控制权，导致 pipeline 块无法折叠、{ 和 } 不配对高亮。
- 临时禁用所有非必要 Groovy 相关插件：菜单 →
Preferences → Package Control → Disable Package - 确认只启用
SublimeJenkins和基础运行时（如Package Control、Default） - 重启 Sublime 后测试：光标放在
pipeline {行，按Ctrl+Shift+[应能折叠整个块；若不能，说明仍有语法解析冲突 - 不用强求“完美 Groovy 兼容”——Jenkins Pipeline 是 DSL，不是纯 Groovy，高亮准确比语法严格更重要
真正麻烦的是多级嵌套 script { sh '...' } 里的 Shell 片段，这部分不会高亮，也没必要强求；重点是 Pipeline 层级结构清晰可读，这就够了。
