没错，这完全是环境变量PATH配置缺失导致的问题！

原因分析 #

当你在终端直接输入puppet命令时，系统会按照PATH环境变量里列出的目录顺序去查找可执行文件。而你的系统PATH里并没有包含Puppet的安装目录/opt/puppetlabs/bin，所以bash找不到这个命令；但用完整路径调用时，你直接指定了文件位置，自然就能正常执行。

解决办法 #

我们只需要把Puppet的bin目录添加到PATH里即可，分两种场景：

1. 临时生效（仅当前终端会话）

在终端执行以下命令，立即让当前会话能识别puppet命令：

export PATH=$PATH:/opt/puppetlabs/bin

执行后直接测试puppet --help，应该就能正常输出帮助内容了，但这个改动在你关闭终端或者登出系统后会失效。

2. 永久生效（持久化配置）

根据需求选择以下一种方式：

• 仅对当前用户生效：
  编辑用户主目录下的~/.bashrc或者~/.bash_profile文件，在文件末尾添加一行：

  export PATH=$PATH:/opt/puppetlabs/bin
  

  保存后执行source ~/.bashrc（如果编辑的是.bash_profile就执行source ~/.bash_profile），让配置立即生效。

• 对所有系统用户生效：
  编辑全局配置文件/etc/profile或者/etc/bashrc，同样在末尾添加上述export命令，保存后执行source /etc/profile，或者重新登录系统即可生效。

验证方法 #

配置完成后，执行echo $PATH查看输出，确认/opt/puppetlabs/bin已经出现在路径列表里，再执行puppet --help就可以正常调用了。

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