"zsh: command not found:"这个错误相信大家都不陌生，以前每次遇到这个问题都是Google一下，然后告诉你在xxx文件添加xxx文字，或者在Terminal运行xxx命令即可，有些work，有些不行。

万事皆有因，今天我们就来说一下这个问题发生的时最常见的原因和解决办法，让你下次再遇到这种问题时自己就可以解决不需要在去Googlexxx Gems command not found。

问题通常发生在局部安装了某个Terminal程序之后，此时程序可能在某个ruby gem的bin目录下，或者Application下（如：sublime），需要我们创建一个指向这个地址软链接，可以方便的访问它。例如：

subl . or pod install

Terminal访问程序原理

Linux环境下通常我们将Terminal可访问的程序放在/bin, /usr/bin, /usr/local/bin，有时也会放在~/bin目录下。

那么在Terminal页面打开（其实是shell login）的时候，程序是如何Load进来的呢？过程大致如下：

1. Terminal打开时当前user默认的shell会去读取自己的配置文件，一般在~目录下；
2. 这个配置文件会去export上述几个路径，读取*/bin下的可执行文件；
3. */bin下的可执行文件通常情况下是指向某个路径下的软链接（可以使用ln -s创建）；

问题原因

基于上面的过程，我们在Terminal中访问得到command not found的具体原因可能如下：

1. 当前调用的命令确实没有安装，如："lorem spear"；
2. 当前命令安装了，但是没有创建软链接到*/bin；
3. 当前命令已创建软链接到*/bin，但是所在*/bin路径没有被export；

解决办法

接下来以Mac下的zsh为例给出解决办法：

Linux系统或者其他Shell（如：bash、sh等）只需要换一些shell的配置文件即可。

• 首先zsh的配置文件在~/.zshrc，使用任何编辑器（vim、atom）打开这个文件，搜索export会看到有如下一行：

    `export PATH="/Users/yourname/.rbenv/shims:/opt/iOSOpenDev/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin"`
  

  PATH=后是用:连接的多个*/bin路径^[1]：

  /usr/sbin
  /bin
  /usr/bin
  /usr/local/bin
  

  我的机器中安装了rbenv和iOSOpenDev，所以还 export 了：

  /Users/yourname/.rbenv/shims
  

  有的程序安装时会自动添加自己的*/bin的export或者引导你运行一些命令去添加，原理都是一样的

• 在上面的路径中找一个合适的路径，如/usr/bin或者/usr/local/bin，然后在这个路径下创建一个指向not found那个程序的软链接。

  当然，你也可以像rbenv那样直接将程序所在路径或者一些特定的*/bin整个加到export中。

• 你需要找到not found的这个程序在什么位置，比如：

  • subl在/Applications/Sublime\ Text\ 2.app/Contents/SharedSupport/bin/subl路径下；
  • pod的所在路径可以通过下面命令找到（所有的ruby gems程序都可以通过这种方式找到）:

  $ gem which cocoapods
  /Users/eloy/.gem/ruby/2.0.0/gems/cocoapods-0.29.0/lib/cocoapods.rb
  $ /Users/eloy/.gem/ruby/2.0.0/bin/pod install
  

  如果以后有时间丰富一些常见的case。

• 创建从程序所在位置到*/bin的软链接。创建软链接的命令是ln -s $source $target，-s参数表明创建的链接类型，source表示程序所在位置，target表示软链接的所在路径。

  例如：ln -s /Users/kimimaro/.rbenv/versions/2.0.0-p645/bin/pod /usr/local/bin

• 运行source命令使软链接生效。新创建的软链接在当前的Terminal页面（即没有再次运行shell login）不会生效，需要对当前Shell（在本例中即zsh）的配置文件（在本例中即~/.zshrc）手动执行source来加载。例如：

  source ~/.zshrc

此时再次运行命令已经不会报错了。

脚注

1. 这些系统路径用户使用权限和登录和非登等情况下作用有所不同，，但由于我们绝大部分操作都在登录情况下因此本文范围内不再详述。 ↩