Jenkins执行Shell无法使用zsh/bash，iOS构建命令缺失求助

这个问题我之前帮团队排查过好几次，核心原因是Jenkins默认用sh（Bourne Shell）执行脚本，而你的环境变量只配置在了zsh的.zshrc里——.zshrc只有当zsh以交互式会话启动时才会自动加载，非交互式的shell（不管是sh还是zsh）都不会主动读取它，所以Jenkins执行脚本时根本拿不到npm和pod的路径。

下面给你几个实用的解决方案，按推荐程度排序：

1. 在Jenkins脚本中手动加载zsh环境变量 #

最简单的临时解决方法，直接在脚本开头添加加载.zshrc的命令，确保后续命令能拿到配置的环境变量：

# 加载zsh的环境配置
source ~/.zshrc
# 接下来执行你的构建命令
npm install
pod install

如果Jenkins代理的执行用户不是你日常登录的用户，记得把~换成绝对路径（比如/Users/your_mac_username/.zshrc），避免路径错误。

2. 强制Jenkins用zsh执行脚本 #

如果想全程用zsh运行脚本，可以在Execute Shell的最开头指定zsh的shebang，同时手动加载配置（因为非交互式zsh也不会读.zshrc）：

#!/bin/zsh
# 加载zsh环境变量
source ~/.zshrc
npm install
pod install

或者直接用zsh命令包裹你的脚本内容，更稳妥：

zsh -c '
source ~/.zshrc
npm install
pod install
'

可以先在Mac上执行which zsh确认zsh的实际路径（比如可能是/usr/local/bin/zsh），替换上面的/bin/zsh。

3. 将环境变量迁移到sh能加载的全局配置文件 #

如果不想每次都手动加载，建议把npm和pod的PATH配置迁移到~/.profile或/etc/profile里——这两个文件是sh/bash启动时会自动读取的全局配置文件。

步骤：

• 先在Mac终端里执行which npm和which pod，得到它们的安装路径（比如/usr/local/bin/npm、/usr/local/bin/pod）
• 编辑~/.profile文件，添加下面的内容（替换成你实际的路径）：

export PATH="$PATH:/usr/local/bin"

• 保存后，下次Jenkins用sh执行脚本时，就能自动读到这些路径，不用再手动加载。

4. 在Jenkins代理节点配置全局环境变量 #

最彻底的方法是直接在Jenkins的代理节点配置里设置环境变量，一劳永逸：

1. 登录Jenkins后台，进入「管理节点」
2. 找到你的Mac mini代理，点击「配置」
3. 在「节点属性」里勾选「环境变量」，点击「添加」
4. 添加PATH变量，值填$PATH:/usr/local/bin:/path/to/your/node/bin（根据你实际的npm/pod路径调整）
5. 保存配置，之后这个代理上的所有Jenkins任务都会自动使用这个PATH。

排查小技巧 #

如果还是有问题，可以在脚本开头加两行命令，帮你定位路径问题：

echo "Current PATH: $PATH"
which npm
which pod

看输出里有没有包含npm和pod的目录，就能快速判断是环境变量没加载，还是路径配置错了。

内容的提问来源于stack exchange，提问作者Anantha kumar