402's Dojo

"zsh: command not found"问题的解决办法

"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

我的机器中安装了rbenviOSOpenDev,所以还 export 了:

/Users/yourname/.rbenv/shims

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

  • 在上面的路径中找一个合适的路径,如/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. 这些系统路径用户使用权限登录和非登等情况下作用有所不同,,但由于我们绝大部分操作都在登录情况下因此本文范围内不再详述。 ↩︎

评论