如何確保團隊開發時， everyone 的程式碼都能順利運行？

在 Python 開發中，requirements.txt 是一個非常重要且實用的工具。它不僅能幫助你管理專案的依賴項，還能使專案的部署和協作更加順暢。本文將深入探討 requirements.txt 的作用、使用它的好處，以及如何安裝和匯出這個文件。

什麼是 requirements.txt？

requirements.txt 是一個純文字檔案，用於列出 Python 專案中所有必要的模組和套件，以及它們的版本號。這個文件通常放置在專案的根目錄中，目的是讓其他開發者或部署系統能夠輕鬆地安裝專案所需的所有依賴項。

範例的 requirements.txt 文件可能如下所示：

numpy==1.21.0
pandas==1.3.0
scikit-learn==0.24.2
Flask==2.0.1

表示專案需要 numpy 1.21.0 版本、pandas 1.3.0 版本等模組。當安裝時，這些模組會根據指定的版本被安裝，以確保環境的一致性。

用 requirements.txt 的好處

1. 保持環境一致性：requirements.txt 允許你精確指定專案所需的模組版本，確保在不同環境中（如開發、測試、部署）運行專案時都能保持一致。這有助於避免「在我的機器上沒問題」這類問題。
2. 簡化部署過程：當你將專案部署到伺服器或交給其他開發者時，只需提供 requirements.txt 文件，他們便能一鍵安裝專案的所有依賴項，而無需手動查找和安裝每個模組。
3. 便於協作：在團隊開發中，所有成員可以基於同一個 requirements.txt 文件建立開發環境，避免因不同的模組版本而導致代碼無法兼容的問題。

如何使用 requirements.txt 安裝依賴項

一旦你擁有一個 requirements.txt 文件，可以使用以下命令來安裝文件中列出的所有依賴項：

pip install -r requirements.txt

這條命令會逐行讀取 requirements.txt 文件，並安裝每個列出的模組及其指定的版本。如果該模組已經存在但版本不同，pip 會自動升級或降級至指定版本。

如何匯出 requirements.txt 文件

當你在虛擬環境或專案中安裝了所需的模組後，可以使用 pip 來生成 requirements.txt 文件。這可以幫助你列出當前環境中所有已安裝的依賴項及其版本。

要匯出 requirements.txt，使用以下命令：

pip freeze > requirements.txt

這條命令會將當前環境中的所有已安裝模組及其版本號輸出到 requirements.txt 文件中。匯出的文件將準確地反映你當前環境的狀態，確保其他人可以重現這個環境。

結語

requirements.txt 是 Python 開發中的一個核心工具，能幫助你管理專案的依賴項，並確保不同環境中運行專案的一致性。無論是為了團隊協作、簡化部署過程，還是為了保持環境的可控性。