pip install --user 是唯一正解，将包安装到用户目录（如linux的~/.local/lib/python3.x/site-packages、windows的%appdata%\python\pythonxx\site-packages），无需sudo、不污染系统、不依赖虚拟环境；装完需确认用户路径已加入sys.path，且命令行工具路径（如~/.local/bin）已纳入path。
pip install --user 是唯一正解
不用 sudo、不碰系统目录、不依赖虚拟环境，pip install --user package_name 就是专为“指定当前用户”安装设计的机制。它把包写进你有天然写权限的位置：Linux/macOS 是 ~/.local/lib/python3.x/site-packages/，Windows 是 %APPDATA%\Python\PythonXX\site-packages\。这不是权宜之计，是 pip 官方支持的用户级安装路径。
装完 import 不到？先查 Python 是否真加载了用户路径
常见错觉是“装了但找不到”，实际是 Python 解释器没把用户 site-packages 加进 sys.path。
- 运行
python -c "import site; print(site.getusersitepackages())"，确认输出路径存在且非空 - 再跑
python -c "import sys; print('\n'.join(sys.path))"，看上一步的路径是否在列表里 - 如果不在，检查是否设置了
PYTHONNOUSERSITE=1环境变量，或启动 Python 时加了-s参数（会禁用用户站点） - 临时补救：启动前设
PYTHONPATH，比如 Linux 上export PYTHONPATH=~/.local/lib/python3.9/site-packages
命令行工具（如 black、flake8）装完却提示 command not found
因为 --user 安装的可执行脚本默认放在：
- Linux/macOS：
~/.local/bin/ - Windows：
%APPDATA%\Python\PythonXX\Scripts\
这些路径通常不在系统 PATH 里。
- Linux/macOS：编辑
~/.zshrc或~/.bashrc，加一行export PATH="$HOME/.local/bin:$PATH"，然后source ~/.zshrc - Windows：把
%APPDATA%\Python\Python39\Scripts（版本号按实际替换）手动加进系统环境变量PATH - 验证：运行
which black（macOS/Linux）或where black（Windows），应返回对应路径
虚拟环境中别混用 --user
一旦激活了 venv 或 conda 环境，pip install --user 就失效了——它仍会把包装进用户目录，但该环境只查自己内部的 site-packages，导致 import 失败。
- 正确做法：激活环境后直接
pip install package_name（不加--user，也不用sudo） - 错误信号：终端提示符显示
(myenv)，但pip install --user requests后import requests报错 - Anaconda 用户注意：
base环境也属于此列，优先用conda install，避免混用pip install --user
