### 如何在 Python 项目中使用 requirements.txt 文件来管理依赖项 #### 1. 生成 requirements.txt 文件 在 Python 项目中，`requirements.txt` 文件用于记录项目所需的所有依赖库及其版本号。可以通过以下方法生成该文件： - 使用 `pip freeze` 命令： ```bash pip freeze > requirements.txt ``` 此命令会将当前环境中已安装的所有包及其版本号写入 `requirements.txt` 文件[^4]。 - 使用 `pipreqs` 工具（推荐）： ```bash pip install pipreqs pipreqs ./ --encoding=utf8 --ignore .\.venv\ --force --pypi-server https://pypi.tuna.tsinghua.edu.cn/simple ``` `pipreqs` 工具只会扫描项目路径下的 `.py` 文件，并根据代码中的 `import` 语句生成真正需要的依赖项，避免包含不必要的包[^3]。 - 如果使用现代包管理工具（如 Poetry 或 Pipenv），可以导出 `requirements.txt` 文件： - **Poetry**: ```bash poetry export -f requirements.txt --without-hashes -o requirements.txt ``` - **Pipenv**: ```bash pipenv lock -r > requirements.txt ``` #### 2. 安装依赖项 通过 `requirements.txt` 文件可以快速安装所有依赖项。以下是常见的安装方式： - 直接安装： ```bash pip install -r requirements.txt ``` 这将告诉 `pip` 根据 `requirements.txt` 文件中的内容安装所需的包及其指定的版本[^4]。 - 指定镜像源安装（例如使用清华大学镜像站）： ```bash pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple ``` 使用国内镜像站可以显著提升下载速度[^1]。 - 在服务端集成到自动化工具（如 Jenkins）中： ```bash pip install -i https://pypi.tuna.tsinghua.edu.cn/simple --trusted-host pypi.tuna.tsinghua.edu.cn -r requirements.txt ``` 该命令适用于服务器环境或持续集成/部署场景[^1]。 #### 3. 更新依赖项 如果需要更新依赖项，可以重新生成 `requirements.txt` 文件，或者手动修改文件中的版本号后重新安装。 - 更新并重新生成文件： ```bash pip freeze > requirements.txt ``` 或者使用 `pipreqs` 再次扫描项目文件夹。 - 升级特定依赖项： ```bash pip install --upgrade <package_name> ``` #### 4. 注意事项 - 确保在虚拟环境中操作，以避免污染全局环境。 ```bash python -m venv venv source venv/bin/activate # Linux/Mac venv\Scripts\activate # Windows ``` - 在不同环境中保持一致性，确保 `requirements.txt` 文件中的依赖项和版本号准确无误[^2]。 ---