使用
pip安装、升级和导出 Python 项目依赖，并通过requirements.txt复现项目环境。
推荐先创建并激活虚拟环境：
python -m venv .venv
Windows CMD：
.venv\Scripts\activate.bat
Windows PowerShell：
.venv\Scripts\Activate.ps1
Ubuntu / Debian：
source .venv/bin/activate
后续命令推荐统一使用：
python -m pip
而不是直接使用：
pip
安装最新版本：
python -m pip install requests
一次安装多个软件包：
python -m pip install fastapi uvicorn pandas openpyxl
安装指定版本：
python -m pip install requests==2.32.3
安装某个版本范围：
python -m pip install "fastapi>=0.110,<1.0"
查看所有已安装软件包：
python -m pip list
查看指定软件包信息：
python -m pip show requests
检查是否有可升级的软件包：
python -m pip list --outdated
查看依赖树需要额外安装 pipdeptree：
python -m pip install pipdeptree
python -m pipdeptree
升级 pip：
python -m pip install --upgrade pip
升级某个软件包：
python -m pip install --upgrade requests
简写：
python -m pip install -U requests
python -m pip uninstall requests
跳过确认：
python -m pip uninstall -y requests
将当前虚拟环境的所有软件包及精确版本导出：
python -m pip freeze > requirements.txt
示例：
fastapi==0.115.8
openpyxl==3.1.5
pandas==2.2.3
requests==2.32.3
uvicorn==0.34.0
新电脑、新服务器或重建虚拟环境后：
python -m pip install -r requirements.txt
常见完整流程：
git clone <repository-url>
cd <project-directory>
python -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
Windows CMD：
git clone <repository-url>
cd <project-directory>
py -m venv .venv
.venv\Scripts\activate.bat
python -m pip install -r requirements.txt
requirements.txt 的常用写法固定版本：
requests==2.32.3
pandas==2.2.3
允许补丁版本更新：
requests~=2.32.0
指定最低版本：
fastapi>=0.110
限定版本范围：
fastapi>=0.110,<1.0
安装 Git 仓库中的包：
git+https://github.com/psf/requests.git
对于自己维护的稳定项目，建议优先使用精确版本
==，以保证环境可复现。
如果项目有测试、格式化或代码检查工具，可以拆分依赖文件。
requirements.txt：
fastapi==0.115.8
uvicorn==0.34.0
requests==2.32.3
requirements-dev.txt：
-r requirements.txt
pytest==8.3.4
ruff==0.9.6
安装开发环境依赖：
python -m pip install -r requirements-dev.txt
新增依赖后：
python -m pip install <package-name>
python -m pip freeze > requirements.txt
提交代码前建议确认差异：
git diff requirements.txt
避免因为临时测试安装了大量无关软件包，导致 requirements.txt 变得混乱。
临时指定镜像源：
python -m pip install -i https://pypi.tuna.tsinghua.edu.cn/simple requests
升级 pip 时也可以指定：
python -m pip install --upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple
企业网络或服务器环境下，如果使用内部 PyPI 镜像，应优先遵循公司或团队的统一配置。
ModuleNotFoundError确认正在运行的 Python 与安装依赖的 pip 是否一致：
python -c "import sys; print(sys.executable)"
python -m pip --version
然后重新安装：
python -m pip install <package-name>
pip 命令不存在不要直接使用 pip，尝试：
python -m pip --version
Ubuntu：
python3 -m pip --version
若仍不存在，安装 pip：
sudo apt install -y python3-pip
可以临时使用镜像源：
python -m pip install -i https://pypi.tuna.tsinghua.edu.cn/simple <package-name>
也应检查：
requirements.txt 在不同系统安装失败部分软件包可能与操作系统、Python 版本或 CPU 架构有关。
排查顺序：
确认 Python 主版本一致；
升级 pip：
python -m pip install --upgrade pip
确认是否存在仅支持 Windows、Linux 或特定架构的软件包；
必要时为不同平台维护不同依赖文件。
晋公网安备14010702070602号