如何正确使用pip install --user命令将Python模块安装到用户包路径？

本文共计727个文字，预计阅读时间需要3分钟。

使用 `pip install --user` 命令可以将 Python 模块安装到用户个人目录下的 packages 路径中。这种方法不会影响系统全局的 Python 环境。具体使用方法如下：

shellpip install --user [module_name]

例如，安装一个名为 `example` 的模块：

shellpip install --user example

要查询 `pip install --user` 的具体使用方法，可以使用以下命令：

shellpip install --help --user

输出结果会显示该命令的详细使用说明。

pip install --user 是python中安装module库到用户packages路径中的方法。

参考：

=======================================================

查询 pip install --user 的使用方法： pip install --help

--user Install to the Python user install directory for your platform. Typically ~/.local/, or

%APPDATA%\Python on Windows. (See the Python documentation for site.USER_BASE for full details.)

==============================================

上面的意思是说pip install --user xxx 是将module库默认安装到（windows平台）%APPDATA%\Python ，（非windows平台）~/.local/ 。

经验表明在不论windows平台还是非windows平台下用户目录其实还与用户调用pip时系统路径下的python版本有关系：

在windows平台下，python版本3.7.2， 3.7.5， 3.7.8 解释器时调用pip install --user xxx 都是将module库安装到：

C:\\Users\\xxx(用户名)\\AppData\\Roaming\\Python\\Python37\\site-packages

在windows平台下，python版本3.8.2， 3.8.5， 3.8.8 解释器时调用pip install --user xxx 都是将module库安装到：

C:\\Users\\xxx(用户名)\\AppData\\Roaming\\Python\\Python38\\site-packages

在windows平台下，python版本3.9.2， 3.9.5， 3.9.8 解释器时调用pip install --user xxx 都是将module库安装到：

C:\\Users\\xxx(用户名)\\AppData\\Roaming\\Python\\Python39\\site-packages

比如在windows平台下，python=3.8.3时，执行：

pip install garage --user

文件安装在：

C:\Users\xxx(用户名)\AppData\Roaming\Python\Python38\site-packages\garage

具体如下：

========================================

在Ubuntu系统平台下：

python3.7.11 版本下执行：

pip install garage --user

安装到：

/home/xxx(用户名)/.local/lib/python3.7/site-packages

如：

不过这一过程中， /home/xxx(用户名)/.local/ 下会产生下面文件夹：

bin lib share

=============================================

使用 pip install --user 注意事项：

不论是windows系统下还是在linux系统下，安装到用户的python module路径下面都是相同版本的python所共用的（x.y 形式，如python3.7， 3.8， 3.9），如果这时你使用的是conda工具创建了多个相同大版本下的环境，如test1 (python3.7.5) , test2 (python3.7.6), test3 (python3.7.7) ，

那么在这三个环境下使用 pip install xxxxx --user 都是会把module库安装到同一路径下的，这时候就往往会造成版本冲突的问题，所以说在使用conda工具创建python环境时是不建议使用 pip install --user 方法的。

在某种意义上来说 pip install xxx --user 是为原生系统下python环境在多用户情况时使用的，否则的话意义不大。