克隆Python代码仓库后如何安装项目依赖（附Windows、Mac操作命令）

前置操作 #

• 完成代码克隆后，在对应系统打开命令行终端，切换到本地仓库的根目录（即存放requirements.txt、pyproject.toml、Pipfile等依赖配置文件的文件夹路径）

分场景安装命令（覆盖全平台差异） #

requirements.txt 格式依赖 #

• Mac系统（适配多Python版本共存环境）执行：pip3 install -r requirements.txt
• Windows系统（适配多Python版本共存环境）执行：py -3 -m pip install -r requirements.txt
  *若本地仅配置单一Python3版本，两个系统均可直接执行pip install -r requirements.txt完成安装

pyproject.toml / setup.py 格式依赖 #

• 常规安装（直接安装到当前激活的Python环境）：
  • Mac系统：pip3 install .
  • Windows系统：py -3 -m pip install .
• 可编辑模式安装（适用于二次开发，修改本地代码无需重新安装即可生效）：
  • Mac系统：pip3 install -e .
  • Windows系统：py -3 -m pip install -e .

Pipfile 格式依赖 #

• 先完成pipenv工具安装：
  • Mac系统：pip3 install pipenv
  • Windows系统：py -3 -m pip install pipenv
• 安装项目全部锁定版本依赖：
  • 双系统通用命令：pipenv install

平台专属注意事项 #

• Windows端：
  • 出现命令识别失败时，优先检查Python安装阶段是否勾选“Add Python to PATH”选项
  • 触发权限报错时，以管理员身份重启终端后再执行安装，不要随意修改系统全局环境变量
• Mac端：
  • 禁止直接在系统自带Python环境下全局安装项目依赖，优先创建独立虚拟环境激活后再执行安装，避免破坏系统Python的依赖结构
  • 安装过程触发权限报错时，不要直接添加sudo参数强行安装，优先确认当前是否已激活正确的虚拟环境

内容的提问来源于stack exchange，提问作者user8758206