先看ImportError或AttributeError中的模块名（如requests、numpy），它大概率是冲突源头；再用pip show和pipdeptree定位版本冲突，最后通过venv隔离+pip-tools锁定依赖。
启动失败时先看 ImportError 或 AttributeError 的具体包名
错误信息里出现 ImportError: cannot import name 'xxx' from 'requests' 或 AttributeError: module 'numpy' has no attribute 'array_function'，说明不是代码写错了，而是某个包的版本和当前环境不匹配。关键不是报错行，而是报错中提到的模块名（比如 requests、numpy、pydantic）——它大概率就是冲突源头。
别急着重装，先确认当前装的是哪个版本：pip show requestspython -c "import requests; print(requests.__version__)"
- 如果输出版本和你项目文档/requirements.txt 里写的不一致，说明 pip 安装时被其他依赖“带偏”了
- 如果版本对得上但依然报错，可能是 C 扩展缓存没刷新（尤其 pytest 或多进程场景），重启 Python 进程或清掉
__pycache__和.pytest_cache - 注意区分：错误来自你直接 import 的包，还是它依赖的子包（比如
fastapi报错，实际是pydantic版本不对）
用 pipdeptree 快速定位谁在拉高/压低版本
pipdeptree 是唯一能看清“谁逼你升版、谁卡你降级”的工具。装完后直接跑：
pip install pipdeptreepipdeptree --conflicts
输出里带 [conflict] 的行就是问题节点，例如：
requests==2.31.0
├── httpx==0.27.0 [requires: requests>=2.25.0]
└── some-legacy-tool==1.2.0 [requires: requests==2.25.0, conflict]
-
--reverse --package requests能查出所有依赖requests的包及其约束条件 - 重点看方括号里的
requires:字段，不是你写的那行requirements.txt，而是包自己声明的依赖 - 如果某包要求
requests>=2.30.0，而另一个要求requests==2.25.0，pip 默认选高版本，低版本包就崩
不要直接 pip install --force-reinstall，先切虚拟环境
全局环境里硬调版本，只会让下个项目更难启动。正确路径是：从头隔离。
立即学习“Python免费学习笔记（深入）”；
python -m venv .venvsource .venv/bin/activate（macOS/Linux）或 .venv\Scripts\activate.bat（Windows）
- 激活后立刻执行
which python（macOS/Linux）或where python（Windows），确保路径指向.venv内部 -
pip list应只显示pip、setuptools、wheel—— 空环境才是干净起点 - 如果仍装到全局，检查是否用了 PowerShell 而没设执行策略：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser - IDE（如 VS Code）右下角 Python 解释器必须手动选
.venv/bin/python，终端激活 ≠ 编辑器生效
用 pip-tools 锁定而非猜测兼容版本
靠人肉试 requests==2.28.2、requests==2.30.0 效率低且不可复现。用 pip-tools 把决策交给解析器：
pip install pip-tools
写 requirements.in（只写你直接用的包）：fastapinumpyscikit-learn
pip-compile requirements.in → 生成 requirements.txt，里面包含所有递归依赖+精确版本+哈希校验
- 部署或重装时只用
pip install -r requirements.txt，不加--force-reinstall - 升级某个包？改
requirements.in后重新pip-compile，它会自动算出兼容的numpy、pydantic等版本 -
requirements.txt必须提交到 Git —— 它不是中间产物，是你项目依赖的唯一事实来源
最常被忽略的一点：冲突往往不出现在你写的代码里，而出现在测试运行时加载的 C 扩展缓存，或者 IDE 没真正切换解释器上下文。验证是否真隔离，永远看 python -c "import sys; print(sys.executable)" 输出的路径。
