--user 是无 root 权限时唯一可靠的 pip 安装方式，将包装入 ~/.local/lib/python3.x/site-packages/ 且自动加入 sys.path；命令行工具需确保 ~/.local/bin 在 $PATH 中；升级卸载也必须加 --user。
pip install --user 是唯一靠谱的解法
没 root 权限时，pip install 默认往系统目录写，必然报 PermissionError: [Errno 13] Permission denied。加 --user 是 pip 官方支持的用户级安装方式，它会把包装进当前用户的家目录（比如 ~/.local/lib/python3.x/site-packages/），不碰系统路径，也不需要 sudo。
- 必须显式加
--user，哪怕你只装一个包——pip install requests --user - 别用
pip install --prefix=~/.local替代，它不等价，可能漏掉.pth文件或脚本入口，导致 import 失败或命令找不到 - 如果已用 root 装过同名包，用户目录的版本不会自动优先；Python 加载顺序取决于
sys.path，需确认~/.local/lib/python3.x/site-packages/在 sys.path 前段（通常 pip --user 会自动处理，但某些旧版 Python 或自定义环境变量下可能失效）
装完 import 不到？检查 PYTHONPATH 和 sys.path
--user 安装后 import 报 ModuleNotFoundError，大概率是 Python 没把用户 site-packages 加进搜索路径。这不是 pip 没装好，而是解释器启动时没启用用户站点。
- 默认情况下，Python 3.4+ 启用用户站点（
site.ENABLE_USER_SITE == True），但若启动时加了-s参数、或设置了环境变量PYTHONNOUSERSITE=1，就会跳过 - 运行
python -c "import site; print(site.getusersitepackages())"看路径是否输出，再执行python -c "import sys; print('\n'.join(sys.path))"确认该路径是否在列表里 - 如果不在，临时补救：启动 Python 前设
export PYTHONPATH=~/.local/lib/python3.x/site-packages（x 替换为你的 Python 小版本号，如 3.9）；长期方案是检查 shell 配置文件（~/.bashrc或~/.zshrc）里有没有误删或覆盖PYTHONPATH
可执行脚本（如 black、flake8）装了却找不到命令
用 --user 安装带命令行工具的包（比如 black），black 命令仍提示 command not found，是因为可执行文件被放到了 ~/.local/bin/，而这个路径通常不在 $PATH 里。
- 运行
echo $PATH查看当前路径列表，大概率没有~/.local/bin - 临时生效：运行
export PATH=~/.local/bin:$PATH - 永久生效：在
~/.bashrc或~/.zshrc末尾加一行export PATH=~/.local/bin:$PATH，然后source ~/.bashrc - 注意：某些系统（如 Ubuntu）默认在
/etc/skel/.profile里有自动添加~/.local/bin的逻辑，但仅对新用户生效；老账户可能缺失，需手动补
升级或卸载 --user 包要加同样参数
很多人装的时候用 --user，升级或卸载时忘了加，结果操作的是系统级包（失败）或根本没动到用户装的那个版本（看似成功实则无效）。
立即学习“Python免费学习笔记（深入）”；
- 升级：
pip install --upgrade package_name --user，不能省略--user - 卸载：
pip uninstall package_name --user，pip 10+ 才支持--user卸载，旧版 pip 会忽略并尝试删系统包（报错） - 查已装用户包：
pip list --user；查具体包位置：pip show package_name，看Location:行是否以/home/xxx/.local/开头 - 混用系统和用户安装会导致依赖冲突，尤其当两个版本共存时，
import可能加载错版本，调试起来非常隐蔽
--user，再顺手 check 一眼 pip show 和 echo $PATH，比事后 debug 省半小时。 
