引言

在Python項目開發(fā)中，我們經常需要安裝多個依賴庫（比如PyQt5、OpenCV等）。逐個執(zhí)行pip install命令不僅繁瑣，還容易遺漏、出現版本兼容問題。

最高效的解決方案是：創(chuàng)建一個requirements.txt文本文件，手動寫入所有需要的庫名（可指定版本），然后通過一條命令批量安裝所有依賴。本文全程實操，新手也能快速上手。

本文核心：從零教你「創(chuàng)建文件→編寫庫清單→批量安裝→實用拓展」，全程無冗余，直接套用即可。

一、什么是requirements.txt？

requirements.txt 是Python項目的「依賴清單文件」，本質是一個純文本文件，核心作用是：

• 統(tǒng)一項目依賴，避免“我本地能運行，別人運行報錯”的問題；
• 手動編寫需要的庫，批量安裝/卸載，提升開發(fā)效率；
• 方便項目備份、共享，他人拿到文件后，一鍵就能配置好和你一致的開發(fā)環(huán)境。

重點：文件名建議固定為requirements.txt（Python生態(tài)通用約定，pip工具可直接識別），后綴必須是.txt，不能是.txt.txt（需開啟電腦文件后綴顯示）。

二、實操步驟：創(chuàng)建+編寫requirements.txt

全程以「PyCharm項目」為例（適配你的上位機開發(fā)環(huán)境），兩種創(chuàng)建方法，任選一種即可，新手優(yōu)先選方法1。

方法1：手動創(chuàng)建（最直觀，新手首選）

適配場景：新手、不熟悉終端命令，直接通過PyCharm圖形界面操作，零門檻。

1. 打開你的PyCharm項目，定位到「項目根目錄」（和你的.py代碼文件同級，比如和相機對接、PLC通信的核心代碼放在一起）；
2. 右鍵點擊項目根目錄 → 選擇「New」→ 點擊「Text File」；
3. 彈出文件名輸入框，輸入 requirements.txt → 按下Enter確認（注意：無中文、無空格）；
4. 雙擊打開創(chuàng)建好的requirements.txt文件，即可開始手動編寫需要的庫清單。

補充提示：如果找不到項目根目錄，可通過PyCharm左側「Project」面板查看，確保文件和核心代碼同級，避免后續(xù)執(zhí)行命令時找不到文件。

方法2：終端快速創(chuàng)建（熟悉終端者首選）

適配場景：習慣用終端操作，快速創(chuàng)建空文件，無需圖形界面點擊。

1. 打開PyCharm底部的「Terminal」終端（默認在項目根目錄，若不在，輸入cd 項目路徑 切換）；
2. 輸入對應系統(tǒng)的命令，創(chuàng)建空的requirements.txt：
   1. Windows系統(tǒng)（你的開發(fā)環(huán)境，重點記這個）：type nul > requirements.txt
   2. Mac/Linux系統(tǒng)（了解即可）：touch requirements.txt
   3. 按下Enter，終端無報錯，項目根目錄會自動生成requirements.txt文件，雙擊打開即可編寫。

核心：編寫requirements.txt內容（語法超簡單）

語法規(guī)則：每行寫一個庫名，可按需指定版本（推薦指定，避免版本兼容問題），# 開頭的行是注釋，不會被執(zhí)行（可用于標注庫的用途，方便后續(xù)維護）。

寫法1：基礎版（只寫庫名，安裝最新穩(wěn)定版）

適合：對庫版本無特殊要求，只想快速安裝，簡潔高效。

# 注釋：Python上位機依賴清單
# 界面開發(fā)（PyQt5）
PyQt5 pyqt5-tools
# PLC通信相關（Modbus + S7協議，對接PLCSIM）
pymodbus python-snap7
# 相機對接 + 視覺處理
opencv-python
# 對接?？倒I(yè)相機（官方SDK封裝）
hikvision-api
# 輔助工具
numpy
# 保存檢測數據到Excel（上位機剛需）
openpyxl
# 串口通信（備用，對接串口PLC/傳感器）
pyserial

寫法2：進階版（指定版本，推薦項目使用）

推薦理由：Python庫版本更新快，不同版本可能存在兼容性問題（比如PyQt5高版本和pyqt5-tools不匹配、python-snap7版本過高導致無法連接PLCSIM），指定版本能確保環(huán)境一致性。

格式：庫名==版本號（==前后無空格），以下是適配你項目的穩(wěn)定版本組合，可直接復制使用。

# Python上位機依賴清單（指定版本，穩(wěn)定兼容）
# 界面開發(fā)（PyQt5穩(wěn)定版本，避免報錯）
PyQt5==5.15.9
pyqt5-tools==5.15.9.3.0.1
# PLC通信（適配PLCSIM Advanced 5.0）
pymodbus==2.5.3
# Modbus TCP通信，穩(wěn)定無bug
python-snap7==1.4.1
# S7協議，對接西門子PLC/PLCSIM
opencv-python==4.8.1.78
# 穩(wěn)定版，避免取流卡頓
hikvision-api==0.3.5
# ?？迪鄼CSDK封裝，適配MVS SDK
# 輔助工具（版本兼容，無冗余）
numpy==1.24.3
# 適配OpenCV 4.8.1 openpyxl==3.1.2
# 操作Excel，支持批量保存數據
pyserial==3.5
# 串口通信，備用

寫法3：其他常用補充（了解即可）

• 指定版本范圍：比如 numpy>=1.20.0,<1.25.0（安裝1.20.0到1.25.0之間的版本）；
• 從指定地址安裝：比如 git+https://github.com/xxx/xxx.git（適用于安裝第三方開源庫的開發(fā)版）；
• 卸載時使用：和安裝語法一致，后續(xù)會講批量卸載命令。

三、關鍵步驟：批量安裝所有依賴

編寫完requirements.txt后，無需逐個執(zhí)行pip install，一條命令就能批量安裝所有庫，步驟如下：

1. 打開終端，切換到項目根目錄

打開PyCharm的Terminal終端（底部），默認已經在項目根目錄；若不在，輸入以下命令切換（替換為你的項目路徑）：

cd D:\PyCharmProjects\PLC_Camera_UpperComputer # 示例路徑，替換成你自己的

2. 核心安裝命令（必記）

基礎命令（從官方PyPI源安裝）：

pip install -r requirements.txt

執(zhí)行后，pip會自動讀取requirements.txt中的所有庫，逐個下載、安裝，終端會顯示安裝進度，全部顯示Successfully installed即安裝完成。

3. 優(yōu)化命令（國內鏡像源，解決安裝慢、超時）

重點避坑：國內網絡訪問Python官方PyPI源（國外服務器）速度較慢，經常出現超時、安裝失敗的問題，推薦使用 國內鏡像源 加速，命令如下（阿里云鏡像源，速度最快，優(yōu)先選）：

# 阿里云鏡像源（推薦，適配國內網絡） 
pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/ 
# 清華鏡像源（備選，穩(wěn)定） 
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple/

補充：鏡像源只是加速下載，安裝的庫和官方源完全一致，無需擔心版本問題。

四、實用拓展命令（必記，提升效率）

除了批量安裝，還有3個常用命令，適配項目備份、環(huán)境清理，結合你的上位機項目非常實用。

1. 導出當前環(huán)境的所有庫到requirements.txt

場景：你已經手動安裝好了所有需要的庫，想快速生成requirements.txt（用于備份、共享給他人），執(zhí)行以下命令：

pip freeze > requirements.txt

執(zhí)行后，會自動覆蓋（或生成）requirements.txt，寫入當前環(huán)境已安裝的所有Python庫及對應版本，無需手動編寫。

2. 批量卸載所有依賴（慎用）

場景：清理開發(fā)環(huán)境、重新配置依賴，執(zhí)行以下命令，會批量卸載requirements.txt中的所有庫：

pip uninstall -r requirements.txt -y

說明：-y 參數表示“自動確認卸載”，無需逐個輸入y確認，提升效率；慎用，避免誤刪環(huán)境。

3. 安裝時指定requirements.txt路徑

場景：requirements.txt不在當前終端目錄下（比如放在桌面），無需切換目錄，直接指定文件路徑即可：

pip install -r D:\Desktop\requirements.txt -i https://mirrors.aliyun.com/pypi/simple/

以上就是Python項目中requirements.txt的使用方法詳解的詳細內容，更多關于Python requirements.txt用法的資料請關注腳本之家其它相關文章！

最新評論