Ubuntu系统下pip安装web3报错：权限问题致缓存禁用

嘿，这个问题我太熟了！之前用sudo装Python包的时候也踩过这个坑，先把你遇到的错误信息贴出来方便大家参考：

执行命令$ sudo pip install web3后，系统提示：目录'/home/chris/.cache/pip/http'或其父目录不属于当前用户，缓存已被禁用，请检查该目录的权限和所有者。如果使用sudo执行pip，建议使用sudo的-H选项。此外，目录'/home/chris/.cache/pip'或其父目录不属于当前用户，wheel缓存已被禁用，请检查权限相关设置。

问题原因 #

这事儿的核心是sudo的环境变量问题：默认情况下，sudo不会重置HOME环境变量，所以当你用sudo pip时，pip会试图去访问当前用户（chris）的~/.cache/pip目录，但此时进程是以root身份运行的，这个目录的所有者却是chris，pip的安全校验会认为“当前运行用户和目录所有者不匹配”，于是就禁用缓存并抛出权限错误。

解决办法 #

1. 用sudo的-H选项（官方推荐的快速解决）

直接给sudo加-H参数，它会把HOME环境变量设置为root的主目录，这样pip就会用root的缓存目录，自然不会有权限冲突：

sudo -H pip install web3

2. 修复缓存目录权限（不推荐，可能留隐患）

如果你非要用当前用户的缓存目录，可以修改目录的所有者为root，但这么做可能会导致后续你自己用pip时又遇到权限问题，所以谨慎选择：

sudo chown -R root:root /home/chris/.cache/pip

3. 用户级安装（最佳实践，彻底避免权限问题）

其实更建议你不要用sudo装Python包，而是用--user参数把包安装到当前用户的专属目录里，完全不会碰系统级的权限：

pip install web3 --user

安装完成后，包会存在~/.local/lib/pythonX.X/site-packages（X.X是你的Python版本），只要~/.local/bin在你的系统PATH里，相关命令就能正常使用。

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