应创建虚拟环境隔离安装：用 python -m venv myenv，再激活后 pip install；避免权限问题和系统环境污染，同时确保 python 与 pip 匹配，git 依赖需正确配置版本与路径。
pip install 为什么报错 “PermissionError: [WinError 5]” 或 “Operation not permitted”
Windows 上用 pip install 报 PermissionError，Mac/Linux 上提示 Operation not permitted，本质是权限不足，但直接加 sudo 或以管理员身份运行不是好解法——它会污染系统 Python 环境，后续升级或卸载容易出问题。
真正该做的是隔离环境：
- 优先用
python -m venv myenv创建虚拟环境，再source myenv/bin/activate（Linux/macOS）或myenv\Scripts\activate（Windows）激活 - 激活后所有
pip install都只影响当前环境，无需额外权限 - Mac M1/M2 用户若遇到
zsh: command not found: pip，说明没装 Python 或未把pip加入 PATH，建议用brew install python安装，它自带pip - 不要用系统自带的 Python（比如 macOS 自带的
/usr/bin/python3），它的pip被锁定，强行写入可能触发 SIP 保护
pip install 后 import 失败：模块找不到的常见原因
pip install requests 成功，但 import requests 报 ModuleNotFoundError，大概率是 Python 解释器和 pip 不匹配。
验证方法很简单：
立即学习“Python免费学习笔记（深入）”；
- 运行
which python（macOS/Linux）或where python（Windows），看当前用的是哪个 Python - 再运行
python -m pip show requests，确认这个python对应的 pip 是否真装了requests - 如果用的是 VS Code 或 PyCharm，检查右下角显示的 Python 解释器路径是否和终端一致；IDE 可能默认用了另一个环境
- 避免混用
pip和python -m pip：前者调用的是 PATH 中第一个pip，后者强制调用当前python自带的 pip，更可靠
requirements.txt 里带 git+https:// 的包怎么安全安装
项目依赖里出现 git+https://github.com/xxx/yyy.git@main 这种写法很常见，但直接 pip install -r requirements.txt 可能失败或行为异常。
关键点在于 Git 依赖的解析和缓存机制：
- 确保已安装
git命令且在 PATH 中，否则 pip 会报subprocess.CalledProcessError - Git URL 默认不带哈希校验，升级时可能拉到意外提交；推荐写成
git+https://github.com/xxx/yyy.git@v1.2.3#subdirectory=src或加上@<hash></hash>锁定版本 - 如果公司内网无法访问 GitHub，可提前用
git clone下载到本地，然后写成-e file:///path/to/local/repo（注意是三个斜杠） - 使用
-e（editable 模式）安装 Git 包时，pip 会在本地建一个 egg-link，修改源码立刻生效，适合开发调试；但上线部署务必去掉-e，否则部署机上没 Git 就装不上
pip list 显示的包名和 import 名不一致怎么办
比如 pip list 里看到 PyYAML，但代码里要 import yaml；又或者装了 python-dotenv，却要 from dotenv import load_dotenv。这不是 bug，是包作者定义的导入名（__name__ 或 __package__）和 PyPI 包名分离导致的。
查清楚对应关系最省事：
- 用
pip show PyYAML看输出里的Name:（PyPI 名）和Summary:（通常含导入提示） - 更准的方法是查官方文档首页，或进包的 GitHub README，一般第一行就有
import xxx示例 - 别靠名字猜：比如
django-crispy-forms导入是crispy_forms，flask-sqlalchemy是flask_sqlalchemy，中间横线变下划线是常见规律，但不保底 - 实在不确定，临时装完运行
python -c "import pkgutil; print([name for _, name, _ in pkgutil.iter_modules()])"看有哪些可导入名（仅限已安装包）
包名和导入名不一致这事本身没法改，只能接受。最容易卡壳的地方其实是没意识到它们本就不必一样——你记不住的时候，就查 pip show，比背规则快得多。
