Jenkins声明式流水线里怎么设置环境变量？

端木卓尚提问于 2026-03-17 23:14:20 阅读 2

工具

我在写Jenkins的Declarative Pipeline，想在pipeline里定义一个全局的环境变量，比如API_URL，但不知道该放哪儿。试过放在agent外面，结果报错说语法不对。

看到文档说可以用environment块，但不确定是不是要放在stage里面还是整个pipeline顶层。我现在的写法像这样：

pipeline {
    agent any
    environment {
        API_URL = 'https://api.example.com'
    }
    stages {
        stage('Build') {
            steps {
                sh 'echo $API_URL'
            }
        }
    }
}

这样写对吗？为啥有时候变量没生效？是不是位置放错了？

我来解答赞 0 收藏

反馈

1 条解答

程序员广红 Lv1

你的写法是对的，environment块放在pipeline顶层、agent外面是完全正确的姿势。

变量没生效大概率是因为sh步骤里的单引号问题。shell里单引号不会解析变量，所以改成这样：

pipeline {
agent any
environment {
API_URL = 'https://api.example.com'
}
stages {
stage('Build') {
steps {
sh "echo $API_URL"
sh 'echo ${API_URL}'
}
}
}
}

要么用双引号让变量展开，要么用${API_URL}明确指定。

另外在Jenkins里environment定义的变量在代码里访问要用${env.API_URL}，比如在脚本式步骤里或者when条件中。

顺带提一句，如果是全局需要用的凭证啥的，用credentials()方法绑定到environment里更安全，别硬编码写在代码中。

2026-03-17 23:24