"zsh: command not found:
"这个错误相信大家都不陌生,以前每次遇到这个问题都是Google一下,然后告诉你在xxx
文件添加xxx
文字,或者在Terminal运行xxx
命令即可,有些work,有些不行。
万事皆有因,今天我们就来说一下这个问题发生的时最常见的原因和解决办法,让你下次再遇到这种问题时自己就可以解决不需要在去Google
xxx 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进来的呢?过程大致如下:
- Terminal打开时当前user默认的shell会去读取自己的配置文件,一般在
~
目录下; - 这个配置文件会去
export
上述几个路径,读取*/bin
下的可执行文件; -
*/bin
下的可执行文件通常情况下是指向某个路径下的软链接(可以使用ln -s
创建);
问题原因
基于上面的过程,我们在Terminal中访问得到command not found
的具体原因可能如下:
- 当前调用的命令确实没有安装,如:"lorem spear";
- 当前命令安装了,但是没有创建软链接到
*/bin
; - 当前命令已创建软链接到
*/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
此时再次运行命令已经不会报错了。
脚注
-
这些系统路径用户使用权限和登录和非登等情况下作用有所不同,,但由于我们绝大部分操作都在登录情况下因此本文范围内不再详述。 ↩