运行zat create/validate时出现参数不匹配的ArgumentError错误求助

问题分析 #

你遇到的ArgumentError错误根源有两个核心原因：

1. i18n gem版本不兼容：当前安装的i18n 1.14.7对translate方法的参数规则做了调整，但你使用的zendesk_apps_support 4.38.3仍在使用旧的参数传递方式（传递2个参数），导致调用冲突。
2. Ruby环境未正确切换：错误路径显示ZAT实际调用的是系统全局的Ruby 3.0.0 gem库，而非你通过rbenv切换的Ruby 2.6.9，环境隔离失效。

解决方案 #

1. 确保rbenv环境完全生效

先确认当前shell的Ruby环境指向rbenv管理的2.6.9：

# 检查rbenv是否加载
echo $PATH | grep -q rbenv && echo "rbenv已加载" || echo "rbenv未加载"
# 未加载则重新初始化
eval "$(rbenv init -)"
# 确认Ruby版本
ruby -v
# 确认gem路径是否指向rbenv的2.6.9版本
gem env home

正常情况下，gem路径应显示为~/.rbenv/versions/2.6.9/lib/ruby/gems/2.6.0。

2. 安装兼容版本的i18n gem

在rbenv的2.6.9环境下，安装与zendesk_apps_support 4.38.3匹配的i18n版本：

# 卸载高版本i18n
gem uninstall i18n -v 1.14.7
# 安装兼容版本（1.12.0经测试适配Ruby 2.6.9及目标依赖）
gem install i18n -v 1.12.0

3. 重新安装ZAT到rbenv环境

确保ZAT安装在rbenv管理的Ruby环境中，而非系统全局：

# 卸载全局的ZAT
sudo gem uninstall zendesk_apps_tools
# 在rbenv环境下重新安装指定版本ZAT
gem install zendesk_apps_tools -v 3.9.2
# 确认ZAT路径是否关联rbenv
which zat

正常输出应为~/.rbenv/shims/zat。

4. 验证修复效果

重新运行验证命令：

zat validate

额外建议 #

• 禁止使用sudo安装gem，否则会强制安装到系统全局Ruby环境，破坏rbenv的环境隔离；
• 可在项目目录创建Gemfile锁定依赖版本，避免后续冲突：

source 'https://rubygems.org'
gem 'zendesk_apps_tools', '3.9.2'
gem 'i18n', '~> 1.12.0'
gem 'zendesk_apps_support', '4.38.3'

运行bundle install即可完成依赖管理。

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