必须安装 sublimejenkins 插件并手动设置语法为 jenkinsfile，因其专为 pipeline dsl 设计，支持关键字高亮、块折叠；groovy 插件无法识别 agent/stage/steps 等语义结构，且多插件共存会导致冲突。
Sublime Text 本身不理解 Jenkins Pipeline DSL，直接打开 Jenkinsfile 就是纯文本或错配成 Groovy，pipeline、stage、steps 这些关键字不会高亮，缩进也容易崩。这不是你写错了，是 Sublime 根本没加载对的语法解析规则。
为什么 Groovy 插件不能直接支持 Jenkinsfile？
因为 Jenkins Pipeline 是基于 Groovy 的受限 DSL：它禁用部分 Groovy 特性（如循环、变量重赋值），又新增了 agent、stages、script 等专属块结构。通用 Groovy 插件（比如 Gr8 或老版 Groovy）只认语法骨架，不识别这些语义层关键词，所以 stage('Build') 和普通函数调用一样显示，无法折叠、无法区分上下文。
- 装了 Gr8 插件后
build.gradle高亮正常，但打开Jenkinsfile仍无反应——说明插件没覆盖 Jenkins 专用语法 - 手动设为 Groovy 语法后，
pipeline { ... }块无法折叠，{和}不配对高亮——这是解析器未适配 Pipeline 语法树导致的 - 如果同时启用了多个 Groovy 相关插件（如 Gr8 + Groovy + SublimeJenkins），它们会互相劫持语法控制权，反而让高亮更不稳定
必须用 SublimeJenkins 插件，且正确关联文件名
社区维护的 SublimeJenkins 是目前唯一专为 Jenkins Pipeline DSL 设计的 Sublime 语法包，它不是简单复用 Groovy 规则，而是单独定义了 pipeline、agent、stages、stage、steps、script 等关键字的 scope 和折叠规则。
- 用
Ctrl+Shift+P→Package Control: Install Package→ 搜索并安装SublimeJenkins（作者 guillermooo） - 安装后重启 Sublime，打开任意
Jenkinsfile，右下角应显示Jenkinsfile；若仍显示Groovy，右键 →Set Syntax → Jenkinsfile手动指定一次 - 要让所有
Jenkinsfile自动匹配，进Preferences → Settings – Syntax Specific，在右侧加：{"extensions": ["Jenkinsfile"]} - 注意大小写：如果项目里有
jenkinsfile（全小写）或JENKINSFILE，需写成["Jenkinsfile", "jenkinsfile", "JENKINSFILE"]，Sublime 不自动忽略大小写
运行 Jenkinsfile？别试了，Sublime 不该干这事
有人想点 Ctrl+B 直接“运行” Jenkinsfile，这注定失败。Jenkinsfile 不是脚本能被 groovy 命令解释执行的——它必须由 Jenkins Master 解析、校验、分发到 agent 上执行。本地用 groovy Jenkinsfile 只会报 Unknown stage directive: pipeline 或空指针，毫无意义。
- 真正需要的是语法校验：靠 Jenkins 实例的
/pipeline-model-converter/validate端点（VSCode 的 Jenkins Pipeline Linter Connector 就走这条路），Sublime 没这类集成能力 - 如果硬要本地模拟，只能用 Jenkins CLI 或 docker run jenkins/jenkins:lts 手动触发，和 Sublime 无关
- 所谓“运行 Groovy”只适用于独立
.groovy脚本，不是Jenkinsfile。两者用途、执行环境、语法约束完全不同
Groovy 支持和 Jenkinsfile 支持必须分开配
你可能既写 build.gradle，又写 Jenkinsfile，但它们需要不同的语法支持和构建系统，混用会导致冲突。
-
.groovy和.gradle文件：用Gr8插件 + Groovy 构建系统（"cmd": ["groovy", "$file"]） -
Jenkinsfile文件：用SublimeJenkins插件 + 无构建系统（禁用 Build System，避免误触） - 不要给
Jenkinsfile配 Groovy 构建系统，否则Ctrl+B会调用groovy Jenkinsfile并失败，还可能掩盖语法错误提示 - 如果发现
Jenkinsfile折叠异常或括号不匹配，先检查是否禁用了其他 Groovy 插件——SublimeJenkins必须是唯一的 Groovy 类语法提供者
最易被忽略的一点：Sublime 对 Jenkinsfile 的支持仅限于静态语法高亮与基础折叠，它不校验 DSL 合法性、不提示缺失的 agent、不警告 stage 嵌套错误。这些必须靠 Jenkins 实例本身的 linter 或 Blue Ocean 编辑器来把关。别把编辑器当 CI 平台用。
