使用Ansible Macports模块在Mac上安装jq/nodejs12失败求助

我之前碰到过几乎一样的情况，这大概率是环境变量PATH不匹配或者MacPorts包未正确激活导致的——毕竟openjdk11和git能正常使用，说明MacPorts本身的安装基础是没问题的。下面是具体的排查和解决步骤：

1. 检查MacPorts默认路径是否在用户PATH中 #

MacPorts安装的可执行文件默认放在/opt/local/bin和/opt/local/sbin目录下。先在终端里执行：

echo $PATH

看看输出里有没有这两个路径。如果没有，需要把它们添加到你的shell配置文件里：

• 如果你用的是Mac默认的zsh，编辑~/.zshrc，添加一行：

  export PATH=/opt/local/bin:/opt/local/sbin:$PATH
  

• 如果你用bash，编辑~/.bash_profile或~/.bashrc，添加同样的内容。

添加后执行source ~/.zshrc（对应你的shell配置文件）让修改生效，再试试jq --version。

2. 确认jq和nodejs12是否被MacPorts激活 #

部分多版本包（比如nodejs的不同分支）需要手动激活，才能让系统识别到对应的命令。执行以下命令检查激活状态：

sudo port active jq
sudo port active nodejs12

如果输出显示The following ports are currently active:加上对应的包名，说明已经激活；如果没有，执行激活命令：

sudo port activate jq
sudo port activate nodejs12

激活完成后再测试命令。

3. 排查Ansible运行时的环境变量差异 #

Ansible如果通过sudo运行，它使用的PATH可能和你登录终端的PATH不一样。可以在Playbook里加个任务，打印Ansible运行时的PATH：

- name: 打印当前Ansible环境的PATH
  command: echo $PATH
  register: ansible_path
- name: 显示PATH内容
  debug:
    var: ansible_path.stdout

运行Playbook后，如果输出里没有/opt/local/bin，说明sudo的环境没有包含MacPorts路径。这时候可以修改sudoers文件（必须用visudo编辑，避免语法错误），找到secure_path一行，把/opt/local/bin:/opt/local/sbin加进去，比如：

Defaults    secure_path = /usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/opt/local/bin:/opt/local/sbin

4. 验证包的实际安装位置 #

最后可以确认jq和nodejs12的可执行文件是否真的存在：

sudo port contents jq
sudo port contents nodejs12

查看输出里的可执行文件路径（比如jq应该在/opt/local/bin/jq），如果文件存在但PATH里没有这个目录，回到步骤1添加路径即可。

一般来说，做完前两步就能解决问题了，毕竟其他包正常工作，说明MacPorts的核心路径是通的，只是这两个包的激活状态或者PATH配置有遗漏。

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