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

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

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

一、什么是requirements.txt？

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

• 統(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圖形界面操作，零門檻。

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

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

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

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

打開PyCharm底部的「Terminal」終端（默認在項目根目錄，若不在，輸入cd 項目路徑 切換）；

輸入對應(yīng)系統(tǒng)的命令，創(chuàng)建空的requirements.txt：

• Windows系統(tǒng)（你的開發(fā)環(huán)境，重點記這個）：type nul > requirements.txt
• Mac/Linux系統(tǒng)（了解即可）：touch requirements.txt

按下Enter，終端無報錯，項目根目錄會自動生成requirements.txt文件，雙擊打開即可編寫。

核心：編寫requirements.txt內(nèi)容（語法超簡單）

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

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

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

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

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

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

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

# 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協(xié)議，對接西門子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，支持批量保存數(shù)據(jù)
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ù)會講批量卸載命令。

三、關(guān)鍵步驟：批量安裝所有依賴

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

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

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

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

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

基礎(chǔ)命令（從官方PyPI源安裝）：

pip install -r requirements.txt

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

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

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

# 阿里云鏡像源（推薦，適配國內(nèi)網(wǎng)絡(luò)） 
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)境清理，結(jié)合你的上位機項目非常實用。

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

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

pip freeze > requirements.txt

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

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

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

pip uninstall -r requirements.txt -y

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

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

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

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

到此這篇關(guān)于Python實現(xiàn)批量安裝依賴的方法詳解的文章就介紹到這了,更多相關(guān)Python安裝依賴內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論