Jenkins流水线特殊环境变量疑问：NODE_NAME访问异常及相关咨询

嘿，这个问题问到点子上了，很多刚接触Jenkins Pipeline的同学都会碰到这个困惑，我来一步步给你解释清楚：

1. 为什么Jenkins流水线里会有NODE_NAME这类特殊“环境变量”？ #

其实严格来说，NODE_NAME这类变量并不是操作系统层面的环境变量，而是Jenkins为了支撑流水线运行，在内部注入的上下文属性。

Jenkins的流水线是分布式执行的，任务会分配到不同的节点（Agent）上运行，为了让你的流水线脚本能感知当前的运行环境——比如我现在跑在哪个节点上？工作空间在哪？构建编号是多少？——Jenkins就会把这些关键的运行时信息封装成可通过env对象访问的属性，方便你在脚本里随时调用。这类属性的作用就是帮你获取流水线的运行上下文，让脚本更灵活适配不同的执行环境。

2. 为什么env.NODE_NAME能拿到值，但env.getEnvironment()里找不到它？ #

先看你这段代码：

node( label: 'myNodeName' ) { 
    println env.NODE_NAME // 成功打印节点名称 
    env.getEnvironment().each{k,v -> println "${k}:${v}" // 结果中不包含NODE_NAME! } 
}

这里的核心区别在于：

• env.NODE_NAME访问的是env对象的Jenkins内部属性：env在Jenkins Pipeline里是个特殊的全局对象，它不仅封装了操作系统的环境变量，还包含了Jenkins自己维护的上下文属性（比如NODE_NAME、WORKSPACE、BUILD_NUMBER）。
• 而env.getEnvironment()方法返回的是真正的操作系统环境变量集合：也就是那些会被传递到shell命令、脚本执行环境中的变量。NODE_NAME是Jenkins内部用来跟踪节点的属性，不会被注入到操作系统的环境变量里，所以自然不会出现在这个方法的返回结果中。

这完全不是你的操作有误，是这类属性的设计特性导致的。

怎么获取这类特殊属性的完整列表？ #

有两个实用的方法：

• 在流水线里直接打印：可以在脚本里加一行println env.properties，它会输出env对象的所有属性（包括Jenkins内部属性和OS环境变量），不过输出格式可能有点杂乱，需要自己筛选。
• 查看Jenkins内置文档：在你的Jenkins实例中，访问/pipeline-syntax/globals路径，找到env全局变量的说明，里面会列出所有Jenkins提供的特殊上下文属性，还有详细的解释。

内容的提问来源于stack exchange，提问作者Jay Spang