版本號的指定決定了依賴的兼容性，常見寫法有 3 種：

• ==x.y.z：精確版本（推薦），強制安裝指定版本，避免版本兼容問題。
• >=x.y.z：最低版本，安裝不低于該版本的最新版，適合對版本不敏感的依賴。
• ~=x.y.z：兼容版本，允許升級到同系列的小版本（如~=2.1.0可安裝 2.1.1、2.1.9，但不支持 2.2.0）。

場景 2：已有項目（自動生成，主要使用場景）

如果項目已開發(fā)一段時間，手動記錄依賴太麻煩，可借助pip freeze命令自動生成requirements.txt，但有個重要前提：先激活項目的虛擬環(huán)境（否則會把全局所有 Python 包都列出來，導致文件冗余）。

步驟 1：創(chuàng)建并激活虛擬環(huán)境（關(guān)鍵！）

虛擬環(huán)境能隔離不同項目的依賴，避免全局包污染。以 Python 自帶的venv為例：

# 1. 在項目根目錄創(chuàng)建虛擬環(huán)境（venv是環(huán)境目錄名，可自定義）
python -m venv venv  # 或 python3 -m venv venv

# 2. 激活虛擬環(huán)境
# Windows（命令提示符）：
venv\Scripts\activate
# Windows（PowerShell）：
.\venv\Scripts\Activate.ps1
# macOS/Linux：
source venv/bin/activate

激活成功后，終端前綴會出現(xiàn)(venv)，表示當前處于虛擬環(huán)境中。

步驟 2：安裝項目依賴（若未安裝）

在虛擬環(huán)境中，安裝項目所需的所有依賴（比如pip install flask requests），確保項目能正常運行。

步驟 3：自動生成 requirements.txt

執(zhí)行以下命令，將當前虛擬環(huán)境中的所有依賴（及其版本）寫入requirements.txt：

pip freeze > requirements.txt

此時打開項目根目錄，會發(fā)現(xiàn)已生成requirements.txt，內(nèi)容類似：

進階：用 pipreqs 生成更精簡的依賴（推薦）

pip freeze會列出虛擬環(huán)境中的所有依賴（包括項目間接依賴的包，比如安裝flask時自動安裝的werkzeug），導致requirements.txt冗余。而pipreqs工具能只識別項目代碼中實際導入的包，生成更精簡的依賴清單。

使用 pipreqs 的步驟：

• 安裝 pipreqs：

  pip install pipreqs
  

• 進入項目根目錄，執(zhí)行命令生成requirements.txt：

  # --encoding=utf8 解決中文注釋編碼問題
  pipreqs . --encoding=utf8
  

例如，若項目代碼中只導入了flask和requests，pipreqs生成的文件會只有這兩個包，比pip freeze更簡潔。

使用requests生成：

使用pipreqs生成：

四、核心操作：用 requirements.txt 安裝依賴

當你拿到一個帶有requirements.txt的項目（比如從 GitHub 下載），只需一條命令即可安裝所有依賴。

步驟 1：激活虛擬環(huán)境（可選但推薦）

和生成時一樣，先在項目根目錄創(chuàng)建并激活虛擬環(huán)境（避免污染全局依賴）。

步驟 2：安裝所有依賴

執(zhí)行以下命令，pip會自動讀取requirements.txt中的內(nèi)容，安裝所有指定包和版本：

pip install -r requirements.txt

常用擴展參數(shù)

• 升級依賴：如果想將依賴升級到requirements.txt指定版本范圍內(nèi)的最新版（需配合>=或~=寫法）：

  pip install --upgrade -r requirements.txt
  

• 使用國內(nèi)鏡像源（提速）：國內(nèi)直接訪問 PyPI 可能較慢，可指定清華、阿里等鏡像源：

• pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
  

• 不緩存安裝包（節(jié)省空間）：適合 CI/CD 或臨時環(huán)境，避免緩存冗余包：

• pip install -r requirements.txt --no-cache-dir

執(zhí)行命令安轉(zhuǎn)之后，原有的依賴報錯就被解決了。

五、進階技巧：管理多環(huán)境依賴

實際開發(fā)中，項目可能需要區(qū)分開發(fā)環(huán)境和生產(chǎn)環(huán)境的依賴（比如開發(fā)時需要pytest做測試，生產(chǎn)環(huán)境不需要）。這時可以創(chuàng)建多個requirements文件。

示例：多環(huán)境依賴文件結(jié)構(gòu)

plaintext

your_project/
├── requirements.txt       # 生產(chǎn)環(huán)境依賴（核心依賴，如flask、requests）
└── requirements-dev.txt   # 開發(fā)環(huán)境依賴（額外依賴，如pytest、flake8）

1. requirements.txt（生產(chǎn)環(huán)境）

flask==2.3.3
requests==2.31.0
pandas==2.1.0

2. requirements-dev.txt（開發(fā)環(huán)境）

# 先包含生產(chǎn)環(huán)境依賴
-r requirements.txt
# 再添加開發(fā)專屬依賴
pytest==7.4.3          # 測試框架
flake8==6.1.0          # 代碼規(guī)范檢查
black==23.10.1         # 代碼格式化工具

3. 安裝對應(yīng)環(huán)境的依賴

• 生產(chǎn)環(huán)境安裝：pip install -r requirements.txt
• 開發(fā)環(huán)境安裝：pip install -r requirements-dev.txt

六、常見問題與解決方案

問題 1：執(zhí)行pip install -r時報 “版本沖突”

原因：不同依賴包對同一個子依賴的版本要求不一致（比如 A 包需要requests<2.30，B 包需要requests>=2.31）。解決方案：

• 用pipdeptree查看依賴樹，定位沖突來源：pip install pipdeptree && pipdeptree。
• 手動調(diào)整沖突包的版本，找到一個雙方都兼容的版本（比如將 A 包升級到支持requests>=2.31的版本）。

問題 2：pip freeze生成的依賴太多，包含無用包

原因：未激活虛擬環(huán)境，導致全局依賴被寫入。解決方案：

• 刪除現(xiàn)有requirements.txt。
• 按步驟創(chuàng)建并激活項目專屬虛擬環(huán)境，重新安裝依賴后用pip freeze生成。
• 或直接用pipreqs生成精簡版依賴。

問題 3：Windows 下激活虛擬環(huán)境提示 “權(quán)限不足”

原因：PowerShell 默認禁止執(zhí)行腳本。解決方案：

• 以 “管理員身份” 打開 PowerShell。
• 執(zhí)行命令修改執(zhí)行策略：Set-ExecutionPolicy RemoteSigned，輸入Y確認。
• 重新激活虛擬環(huán)境：.\venv\Scripts\Activate.ps1。

七、總結(jié)

requirements.txt看似簡單，卻是 Python 項目規(guī)范化、可移植的關(guān)鍵。掌握它的核心流程：

• 準備：確保pip最新，用虛擬環(huán)境隔離依賴。
• 生成：新項目手動寫，老項目用pip freeze或pipreqs自動生成。
• 安裝：pip install -r requirements.txt一鍵還原環(huán)境。
• 進階：用多文件管理開發(fā) / 生產(chǎn)環(huán)境依賴。

養(yǎng)成在 Python 項目中使用requirements.txt的習慣，能極大減少環(huán)境不一致帶來的麻煩，讓協(xié)作和部署更高效。

到此這篇關(guān)于Python依賴管理神器requirements.txt從安裝到實戰(zhàn)的文章就介紹到這了,更多相關(guān)Python依賴管理神器requirements.txt內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！