Jenkins构建Flutter应用：命令无法识别与系统变量配置问题

核心原因 #

Jenkins默认以独立的系统用户（如jenkins用户）运行，其环境变量与你本地Shell使用的个人用户环境变量不共享——你本地Shell能找到Flutter命令，是因为Flutter的bin目录已添加到个人用户的PATH中，但Jenkins用户的PATH里没有这个路径。

解决办法 #

方法1：在Jenkins全局配置中添加环境变量 #

1. 进入Jenkins后台，依次点击「系统管理」→「系统配置」
2. 找到「全局属性」区域，勾选「环境变量」
3. 添加一个名为PATH的变量，值为原系统PATH + Flutter的bin目录路径，比如：

   $PATH:/home/your-username/flutter/bin
   

   （替换成你实际的Flutter安装路径）
4. 保存配置后，重新触发流水线即可。

方法2：在流水线脚本中使用Flutter绝对路径 #

直接在流水线命令里指定Flutter的完整路径，比如：

sh '/home/your-username/flutter/bin/flutter build apk'
sh '/home/your-username/flutter/bin/flutter devices'

这种方式无需修改全局配置，适合临时测试或单任务场景。

方法3：修改Jenkins用户的Shell配置文件 #

1. 切换到Jenkins用户（需要管理员权限）：

   sudo su jenkins
   

2. 编辑用户的Shell配置文件（比如.bashrc或.profile）：

   nano ~/.bashrc
   

3. 在文件末尾添加Flutter路径到PATH：

   export PATH="$PATH:/home/your-username/flutter/bin"
   

4. 保存退出后，重启Jenkins服务：

   sudo systemctl restart jenkins
   

额外排查点 #

如果使用了Jenkins分布式节点（如Docker代理、远程节点），需要确保对应节点的环境中已安装Flutter，且该节点的运行用户PATH包含Flutter的bin目录。

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