macOS Catalina提示/usr/bin/env参数列表过长 命令执行失败问题求助

报错根因 #

该报错与ulimit默认配置无直接关联，核心是环境变量总长度超出了系统ARG_MAX上限，绝大多数场景是PATH变量被反复追加、长度溢出导致，会影响所有调用/usr/bin/env的命令执行。

排查步骤 #

• 验证环境变量总长度，执行命令：

  env | wc -c
  

  Mac系统默认ARG_MAX上限为256KB，若返回值超过262144即可确认是环境变量溢出问题。
• 排查PATH变量长度，执行命令：

  echo $PATH | wc -c
  

  正常场景下PATH长度不会超过2000字符，若返回值过高则是PATH被重复追加导致。
• 检查shell配置文件的PATH规则，执行命令：

  grep -r "export PATH" ~/.*
  

  确认是否存在循环加载配置、无判断反复追加PATH的代码。

修复方案 #

临时验证方案 #

新开终端执行以下命令，重置基础PATH后验证brew是否可用：

export PATH="/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin"
brew --version

若运行正常即可确认是PATH过长导致的问题。

永久修复方案 #

1. 打开当前使用的shell配置文件：
   • zsh用户编辑~/.zshrc
   • bash用户编辑~/.bash_profile
2. 删除所有重复的export PATH规则，新增PATH去重工具函数：

   add_path() {
       if ! echo "$PATH" | grep -Eq "(^|:)$1($|:)" ; then
           export PATH="$1:$PATH"
       fi
   }
   

3. 后续所有新增PATH路径统一用add_path函数实现，避免重复追加，示例：

   add_path "/usr/local/opt/openjdk/bin"
   add_path "~/.composer/vendor/bin"
   

4. 重载配置生效：

   # zsh用户执行
   source ~/.zshrc
   # bash用户执行
   source ~/.bash_profile
   

ulimit参数修复方案 #

如果需要调整最大文件打开数限制，可按以下步骤操作：

1. 用sudo权限创建/etc/sysctl.conf文件，写入如下内容：

   kern.maxfiles=524288
   kern.maxfilesperproc=524288
   

2. 重启设备后执行ulimit -n 65536即可正常设置参数。

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