Python使用pip遇到依賴沖突警告時候的排查辦法

更新時間：2026年03月12日 09:49:21 作者：Tipriest_

這篇文章記錄了解決pip安裝依賴沖突問題的流程,主要解決步驟包括：確認安裝是否成功、確認報錯提到的沖突包、檢查包的來源和是否需要、決定是刪除包還是補齊依賴,以及建議為每個項目新建獨立的conda環(huán)境,需要的朋友可以參考下

(hello-agent) tipriest@Uranus:~/Documents/hello-agents/code/chapter15/Helloagents-AI-Town/backend (main*) $ pip install -r requirements.txt
Collecting fastapi>=0.104.0 (from -r requirements.txt (line 2))
  Downloading fastapi-0.124.4-py3-none-any.whl.metadata (30 kB)
Collecting uvicorn>=0.24.0 (from uvicorn[standard]>=0.24.0->-r requirements.txt (line 3))
  Downloading uvicorn-0.38.0-py3-none-any.whl.metadata (6.8 kB)
Requirement already satisfied: pydantic>=2.0.0 in /home/tipriest/anaconda3/envs/hello-agent/lib/python3.10/site-packages (from -r requirements.txt (line 4)) (2.12.5)
Requirement already satisfied: requests>=2.31.0 in /home/tipriest/anaconda3/envs/hello-agent/lib/python3.10/site-packages (from -r requirements.txt (line 5)) (2.32.5)
Collecting python-multipart>=0.0.6 (from -r requirements.txt (line 8))
  Downloading python_multipart-0.0.20-py3-none-any.whl.metadata (1.8 kB)
Collecting pytest>=7.4.0 (from -r requirements.txt (line 11))
  Downloading pytest-9.0.2-py3-none-any.whl.metadata (7.6 kB)
Requirement already satisfied: httpx>=0.25.0 in /home/tipriest/anaconda3/envs/hello-agent/lib/python3.10/site-packages (from -r requirements.txt (line 12)) (0.28.1)
Collecting hello-agents>=0.2.4 (from -r requirements.txt (line 15))
  Downloading hello_agents-0.2.8-py3-none-any.whl.metadata (12 kB)
Collecting starlette<0.51.0,>=0.40.0 (from fastapi>=0.104.0->-r requirements.txt (line 2))
  Downloading starlette-0.50.0-py3-none-any.whl.metadata (6.3 kB)
Requirement already satisfied: typing-extensions>=4.8.0 in /home/tipriest/anaconda3/envs/hello-agent/lib/python3.10/site-packages (from fastapi>=0.104.0->-r requirements.txt (line 2)) (4.15.0)
Collecting annotated-doc>=0.0.2 (from fastapi>=0.104.0->-r requirements.txt (line 2))
  Downloading annotated_doc-0.0.4-py3-none-any.whl.metadata (6.6 kB)
Requirement already satisfied: annotated-types>=0.6.0 in /home/tipriest/anaconda3/envs/hello-agent/lib/python3.10/site-packages (from pydantic>=2.0.0->-r requirements.txt (line 4)) (0.7.0)
Requirement already satisfied: pydantic-core==2.41.5 in /home/tipriest/anaconda3/envs/hello-agent/lib/python3.10/site-packages (from pydantic>=2.0.0->-r requirements.txt (line 4)) (2.41.5)
Requirement already satisfied: typing-inspection>=0.4.2 in /home/tipriest/anaconda3/envs/hello-agent/lib/python3.10/site-packages (from pydantic>=2.0.0->-r requirements.txt (line 4)) (0.4.2)
Requirement already satisfied: anyio<5,>=3.6.2 in /home/tipriest/anaconda3/envs/hello-agent/lib/python3.10/site-packages (from starlette<0.51.0,>=0.40.0->fastapi>=0.104.0->-r requirements.txt (line 2)) (4.12.0)
Requirement already satisfied: exceptiongroup>=1.0.2 in /home/tipriest/anaconda3/envs/hello-agent/lib/python3.10/site-packages (from anyio<5,>=3.6.2->starlette<0.51.0,>=0.40.0->fastapi>=0.104.0->-r requirements.txt (line 2)) (1.3.1)
Requirement already satisfied: idna>=2.8 in /home/tipriest/anaconda3/envs/hello-agent/lib/python3.10/site-packages (from anyio<5,>=3.6.2->starlette<0.51.0,>=0.40.0->fastapi>=0.104.0->-r requirements.txt (line 2)) (3.11)
Collecting click>=7.0 (from uvicorn>=0.24.0->uvicorn[standard]>=0.24.0->-r requirements.txt (line 3))
  Downloading click-8.3.1-py3-none-any.whl.metadata (2.6 kB)
Requirement already satisfied: h11>=0.8 in /home/tipriest/anaconda3/envs/hello-agent/lib/python3.10/site-packages (from uvicorn>=0.24.0->uvicorn[standard]>=0.24.0->-r requirements.txt (line 3)) (0.16.0)
Requirement already satisfied: charset_normalizer<4,>=2 in /home/tipriest/anaconda3/envs/hello-agent/lib/python3.10/site-packages (from requests>=2.31.0->-r requirements.txt (line 5)) (3.4.4)
Requirement already satisfied: urllib3<3,>=1.21.1 in /home/tipriest/anaconda3/envs/hello-agent/lib/python3.10/site-packages (from requests>=2.31.0->-r requirements.txt (line 5)) (2.6.2)
Requirement already satisfied: certifi>=2017.4.17 in /home/tipriest/anaconda3/envs/hello-agent/lib/python3.10/site-packages (from requests>=2.31.0->-r requirements.txt (line 5)) (2025.11.12)
Collecting iniconfig>=1.0.1 (from pytest>=7.4.0->-r requirements.txt (line 11))
  Downloading iniconfig-2.3.0-py3-none-any.whl.metadata (2.5 kB)
Requirement already satisfied: packaging>=22 in /home/tipriest/anaconda3/envs/hello-agent/lib/python3.10/site-packages (from pytest>=7.4.0->-r requirements.txt (line 11)) (25.0)
Collecting pluggy<2,>=1.5 (from pytest>=7.4.0->-r requirements.txt (line 11))
  Using cached pluggy-1.6.0-py3-none-any.whl.metadata (4.8 kB)
Requirement already satisfied: pygments>=2.7.2 in /home/tipriest/anaconda3/envs/hello-agent/lib/python3.10/site-packages (from pytest>=7.4.0->-r requirements.txt (line 11)) (2.19.2)
Collecting tomli>=1 (from pytest>=7.4.0->-r requirements.txt (line 11))
  Using cached tomli-2.3.0-py3-none-any.whl.metadata (10 kB)
Requirement already satisfied: httpcore==1.* in /home/tipriest/anaconda3/envs/hello-agent/lib/python3.10/site-packages (from httpx>=0.25.0->-r requirements.txt (line 12)) (1.0.9)
Collecting openai<2.0.0,>=1.0.0 (from hello-agents>=0.2.4->-r requirements.txt (line 15))
  Downloading openai-1.109.1-py3-none-any.whl.metadata (29 kB)
Requirement already satisfied: python-dotenv<2.0.0,>=0.19.0 in /home/tipriest/anaconda3/envs/hello-agent/lib/python3.10/site-packages (from hello-agents>=0.2.4->-r requirements.txt (line 15)) (1.2.1)
Collecting beautifulsoup4<5.0.0,>=4.9.0 (from hello-agents>=0.2.4->-r requirements.txt (line 15))
  Downloading beautifulsoup4-4.14.3-py3-none-any.whl.metadata (3.8 kB)
Collecting numpy<3.0.0,>=2.0.0 (from hello-agents>=0.2.4->-r requirements.txt (line 15))
  Using cached numpy-2.2.6-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.metadata (62 kB)
Collecting networkx<4.0.0,>=2.6.0 (from hello-agents>=0.2.4->-r requirements.txt (line 15))
  Using cached networkx-3.4.2-py3-none-any.whl.metadata (6.3 kB)
Requirement already satisfied: tiktoken>=0.5.0 in /home/tipriest/anaconda3/envs/hello-agent/lib/python3.10/site-packages (from hello-agents>=0.2.4->-r requirements.txt (line 15)) (0.12.0)
Collecting soupsieve>=1.6.1 (from beautifulsoup4<5.0.0,>=4.9.0->hello-agents>=0.2.4->-r requirements.txt (line 15))
  Downloading soupsieve-2.8-py3-none-any.whl.metadata (4.6 kB)
Requirement already satisfied: distro<2,>=1.7.0 in /home/tipriest/anaconda3/envs/hello-agent/lib/python3.10/site-packages (from openai<2.0.0,>=1.0.0->hello-agents>=0.2.4->-r requirements.txt (line 15)) (1.9.0)
Requirement already satisfied: jiter<1,>=0.4.0 in /home/tipriest/anaconda3/envs/hello-agent/lib/python3.10/site-packages (from openai<2.0.0,>=1.0.0->hello-agents>=0.2.4->-r requirements.txt (line 15)) (0.12.0)
Requirement already satisfied: sniffio in /home/tipriest/anaconda3/envs/hello-agent/lib/python3.10/site-packages (from openai<2.0.0,>=1.0.0->hello-agents>=0.2.4->-r requirements.txt (line 15)) (1.3.1)
Requirement already satisfied: tqdm>4 in /home/tipriest/anaconda3/envs/hello-agent/lib/python3.10/site-packages (from openai<2.0.0,>=1.0.0->hello-agents>=0.2.4->-r requirements.txt (line 15)) (4.67.1)
Requirement already satisfied: regex>=2022.1.18 in /home/tipriest/anaconda3/envs/hello-agent/lib/python3.10/site-packages (from tiktoken>=0.5.0->hello-agents>=0.2.4->-r requirements.txt (line 15)) (2025.11.3)
Collecting httptools>=0.6.3 (from uvicorn[standard]>=0.24.0->-r requirements.txt (line 3))
  Downloading httptools-0.7.1-cp310-cp310-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl.metadata (3.5 kB)
Collecting pyyaml>=5.1 (from uvicorn[standard]>=0.24.0->-r requirements.txt (line 3))
  Using cached pyyaml-6.0.3-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl.metadata (2.4 kB)
Collecting uvloop>=0.15.1 (from uvicorn[standard]>=0.24.0->-r requirements.txt (line 3))
  Downloading uvloop-0.22.1-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl.metadata (4.9 kB)
Collecting watchfiles>=0.13 (from uvicorn[standard]>=0.24.0->-r requirements.txt (line 3))
  Downloading watchfiles-1.1.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.metadata (4.9 kB)
Collecting websockets>=10.4 (from uvicorn[standard]>=0.24.0->-r requirements.txt (line 3))
  Using cached websockets-15.0.1-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl.metadata (6.8 kB)
Downloading fastapi-0.124.4-py3-none-any.whl (113 kB)
Downloading starlette-0.50.0-py3-none-any.whl (74 kB)
Downloading uvicorn-0.38.0-py3-none-any.whl (68 kB)
Downloading python_multipart-0.0.20-py3-none-any.whl (24 kB)
Downloading pytest-9.0.2-py3-none-any.whl (374 kB)
Using cached pluggy-1.6.0-py3-none-any.whl (20 kB)
Downloading hello_agents-0.2.8-py3-none-any.whl (251 kB)
Downloading beautifulsoup4-4.14.3-py3-none-any.whl (107 kB)
Using cached networkx-3.4.2-py3-none-any.whl (1.7 MB)
Using cached numpy-2.2.6-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (16.8 MB)
Downloading openai-1.109.1-py3-none-any.whl (948 kB)
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 948.6/948.6 kB 7.1 MB/s  0:00:00
Downloading annotated_doc-0.0.4-py3-none-any.whl (5.3 kB)
Downloading click-8.3.1-py3-none-any.whl (108 kB)
Downloading iniconfig-2.3.0-py3-none-any.whl (7.5 kB)
Downloading soupsieve-2.8-py3-none-any.whl (36 kB)
Using cached tomli-2.3.0-py3-none-any.whl (14 kB)
Downloading httptools-0.7.1-cp310-cp310-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl (440 kB)
Using cached pyyaml-6.0.3-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (770 kB)
Downloading uvloop-0.22.1-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (3.7 MB)
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 3.7/3.7 MB 12.8 MB/s  0:00:00
Downloading watchfiles-1.1.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (455 kB)
Using cached websockets-15.0.1-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl (181 kB)
Installing collected packages: websockets, uvloop, tomli, soupsieve, pyyaml, python-multipart, pluggy, numpy, networkx, iniconfig, httptools, click, annotated-doc, uvicorn, pytest, beautifulsoup4, watchfiles, starlette, openai, fastapi, hello-agents
  Attempting uninstall: openai
    Found existing installation: openai 2.11.0
    Uninstalling openai-2.11.0:
      Successfully uninstalled openai-2.11.0
ERROR: pip's dependency resolver does not currently take into account all the packages that are installed. This behaviour is the source of the following dependency conflicts.
generate-parameter-library-py 0.5.0 requires jinja2, which is not installed.
generate-parameter-library-py 0.5.0 requires typeguard, which is not installed.
Successfully installed annotated-doc-0.0.4 beautifulsoup4-4.14.3 click-8.3.1 fastapi-0.124.4 hello-agents-0.2.8 httptools-0.7.1 iniconfig-2.3.0 networkx-3.4.2 numpy-2.2.6 openai-1.109.1 pluggy-1.6.0 pytest-9.0.2 python-multipart-0.0.20 pyyaml-6.0.3 soupsieve-2.8 starlette-0.50.0 tomli-2.3.0 uvicorn-0.38.0 uvloop-0.22.1 watchfiles-1.1.1 websockets-15.0.1

先說結論：你這次 pip install -r requirements.txt 實際上已經(jīng)安裝成功了，只是 pip 在最后給了一個**“潛在依賴沖突警告”**，提醒你：當前環(huán)境里已經(jīng)安裝的一個包 generate-parameter-library-py 有未滿足的依賴（jinja2、typeguard）。
這和你剛剛裝的 fastapi / hello-agents 等并不直接沖突，只是說明你的環(huán)境里有一個“半殘廢”的包。

下面我按“排查思路”一步步講，今后你遇到類似輸出可以自己判斷、處理。

1. 先讀懂這條報錯在說什么

末尾關鍵幾行：

ERROR: pip's dependency resolver does not currently take into account all the packages that are installed. This behaviour is the source of the following dependency conflicts.
generate-parameter-library-py 0.5.0 requires jinja2, which is not installed.
generate-parameter-library-py 0.5.0 requires typeguard, which is not installed.
Successfully installed ...

含義拆開：

pip's dependency resolver does not currently take into account all the packages that are installed.
- 這句是 pip 的“已知局限”聲明：
  它在解析依賴時主要考慮這次要安裝/升級的包，對環(huán)境里早就存在的老包考慮不充分。
generate-parameter-library-py 0.5.0 requires jinja2, which is not installed.
- 說明你當前環(huán)境中裝了 generate-parameter-library-py==0.5.0，
  但它聲明要依賴 jinja2 和 typeguard，而這兩個當前沒裝。
最后一行 Successfully installed ...
- 證明：這次 requirements.txt 里的包，其實都裝成功了；
  報錯只是對“環(huán)境整體依賴狀態(tài)”的警告。

所以這里不是“fastapi 安裝失敗”，也不是“hello-agents 有問題”，
而是“你的環(huán)境里有個以前裝過的包（generate-parameter-library-py）依賴不齊”。

2. 通用排查步驟（可當小模板用）

以后看到類似 pip 報警，可以按這個順序排查：

步驟 1：確認這次要裝的包有沒有安裝成功

看最后有沒有 Successfully installed ...
或直接進環(huán)境里跑：

python -c "import fastapi, hello_agents; print(fastapi.__version__)"

你這次的輸出明確有 Successfully installed ...，所以當前項目依賴已就緒。

步驟 2：確認報錯里提到的是哪些“沖突包”

本例里是：

generate-parameter-library-py 0.5.0
缺少依賴：jinja2、typeguard

常見兩種情況：

這是你項目里用不到的包
- 可能是你過去在這個環(huán)境里嘗試過別的項目裝的
- 那么可以直接刪掉它，保持環(huán)境干凈
這是你另外一個項目確實需要的包
- 那么就在這個環(huán)境里把它依賴補齊，或者更好的是：給它單獨建一個環(huán)境

步驟 3：查一下這個包從哪來的、是不是當前項目真的需要

在當前 conda 環(huán)境里執(zhí)行：

pip show generate-parameter-library-py

看輸出：

Location：安裝目錄
Required-by：哪些包依賴了它（通常為空說明你是手動裝的）
Version 等信息

如果你發(fā)現(xiàn)：

當前這個“Helloagents-AI-Town”項目的 requirements.txt 里并沒有它
也沒有任何其他依賴它的包

那大概率是個“歷史遺留垃圾包”，可以直接刪。

步驟 4：決定“刪掉它”還是“把依賴補齊”

4.1 如果刪掉它（推薦，環(huán)境更干凈）

在當前 hello-agent 環(huán)境里：

pip uninstall generate-parameter-library-py

然后再跑一次：

pip check

pip check 的作用是：檢查當前環(huán)境里所有已安裝包的依賴是否都滿足。
如果輸出為空 / All good 就說明環(huán)境相對干凈了。

建議：在“專用于某個項目的環(huán)境”里，只保留這個項目真正需要的包，其他歷史包盡量卸載。

4.2 如果你確實還需要這個包（比如是你另一個項目用的）

那就把它依賴補齊即可：

pip install jinja2 typeguard
pip check

之后 pip 再安裝別的東西時，就不會再提這個包的依賴缺失問題了。

但更好的做法是：
給這個“用 generate-parameter-library-py 的項目”單獨建一個 conda 環(huán)境，避免互相污染。

3. 結合你當前環(huán)境，說一套更“干凈”的做法

目前情況：

你在 conda 環(huán)境 hello-agent 里用 pip 裝了這套 AI Town 的依賴
環(huán)境里還殘留一個舊包 generate-parameter-library-py，而它依賴沒裝全

建議今后針對每個項目：

為項目新建一個 conda 環(huán)境（你已經(jīng)這么做了，這是好習慣）：

conda create -n hello-agent python=3.10
conda activate hello-agent

在這個環(huán)境里，只做兩類安裝：

該項目的 requirements.txt
你確實“為了這個項目”需要的額外包

對于不確定來源、其他項目歷史遺留的包（比如這次的 generate-parameter-library-py）：

能卸載就卸載
如果要用，就給它開自己的環(huán)境，不要混在這個項目里

4. 一個“日常排查小 checklist”

以后碰到類似 pip 的長輸出，可以按這個順序：

最后一行有沒有 Successfully installed？

有：本次安裝成功，報錯多半是“環(huán)境整體不一致警告”
沒有：往上翻，找“哪一個包安裝失敗”“是下載失敗還是編譯失敗還是版本沖突”

報錯提到了哪些 package？

是這次要裝的，還是過去殘留的？

對每個提到的包，問自己三個問題：

這個包是當前項目真的需要嗎？
如果不是：pip uninstall 包名
如果是：把它依賴補齊 / 單獨給它一個環(huán)境

最后跑一次：

pip check

看看剩下還有沒有未滿足的依賴。

5. 針對你這個具體例子，可以直接這樣做

在 hello-agent 環(huán)境中：

# 1. 看看這個包到底啥情況（可選）
pip show generate-parameter-library-py
# 2. 如果你確認現(xiàn)在這個項目不需要它，就干脆刪掉
pip uninstall generate-parameter-library-py
# 3. 檢查環(huán)境依賴一致性
pip check

以上就是Python使用pip遇到依賴沖突警告時候的排查辦法的詳細內(nèi)容，更多關于Python pip依賴沖突警告的資料請關注腳本之家其它相關文章！

您可能感興趣的文章:

Python中切片賦值的高級技巧和避坑指南
在 Python 的眾多特性中,列表List的切片賦值無疑是最具Python 風格的操作之一,本文將深入剖析 Python 切片賦值的底層邏輯,揭示其背后的陷阱,并分享幾個能讓你的代碼更健壯、更高效的高級技巧,希望對大家有所幫助
2026-02-02
python 自動化辦公之批量修改文件名實操
這篇文章主要介紹了python 自動化辦公之批量修改文件名實操，文章圍繞主題展開詳細的內(nèi)容介紹，具有一定的參考價值，需要的小伙伴可以參考一下
2022-07-07
Python中的index()方法使用教程
這篇文章主要介紹了Python中的index()方法使用教程,是Python入門學習中的基礎知識,需要的朋友可以參考下
2015-05-05
解決Python訪問MySQL數(shù)據(jù)庫速度慢的問題
這篇文章主要介紹了解決Python訪問MySQL數(shù)據(jù)庫速度慢的問題，具有很好的參考價值，希望對大家有所幫助。一起跟隨小編過來看看吧
2021-04-04
Python實現(xiàn)的大數(shù)據(jù)分析操作系統(tǒng)日志功能示例
這篇文章主要介紹了Python實現(xiàn)的大數(shù)據(jù)分析操作系統(tǒng)日志功能,涉及Python大文件切分、讀取、多線程操作等相關使用技巧,需要的朋友可以參考下
2019-02-02
詳解Python圖像形態(tài)學處理(開運算,閉運算,梯度運算)
數(shù)學形態(tài)學（Mathematical Morphology）是一種應用于圖像處理和模式識別領域的新方法。本文將為大家介紹Python圖像形態(tài)學處理中的開運算、閉運算和梯度運算，感興趣的可以了解一下
2022-06-06
Python實現(xiàn)自動整理文件的腳本
這篇文章主要介紹了Python實現(xiàn)自動整理文件的腳本，幫助大家更好的利用python處理文件，感興趣的朋友可以了解下
2020-12-12
python實現(xiàn)自動生成C++代碼的代碼生成器
這篇文章介紹了python實現(xiàn)C++代碼生成器的方法，文中通過示例代碼介紹的非常詳細。對大家的學習或工作具有一定的參考借鑒價值，需要的朋友可以參考下
2022-07-07
系統(tǒng)梳理Python中配置管理的核心方法與最佳實踐指南
這篇文章主要為大家詳細介紹了Python中配置管理的核心方法與最佳實踐,涵蓋環(huán)境變量,配置文件,密鑰服務和動態(tài)配置中心四大方案,希望對大家有所幫助
2026-03-03
使用PDB模式調(diào)試Python程序介紹
這篇文章主要介紹了使用PDB模式調(diào)試Python程序介紹,本文講解了PDB模式的使用語法,著重講解PDB模式下的常用命令,需要的朋友可以參考下
2015-04-04