如何让其他机器运行Git共享的Python项目？新手求教更简便方案

第一步：导出本地依赖清单 #

先在你本地的虚拟环境里，用pip导出所有已安装的包到requirements.txt文件，不用手动逐个写50个包：

pip freeze > requirements.txt

把这个文件提交到Git仓库，这样其他克隆项目的人就能拿到完整的依赖清单。

第二步：其他机器的操作流程 #

别人拿到项目后，不需要写复杂的.bat文件，按以下步骤操作即可（Windows、Linux/macOS通用，仅创建虚拟环境的命令略有差异）：

1. 克隆项目：先把Git仓库的代码克隆到本地

   git clone <你的仓库地址>
   cd <项目文件夹>
   

2. 创建虚拟环境：
   • Windows：

     python -m venv venv
     

   • Linux/macOS：

     python3 -m venv venv
     

3. 激活虚拟环境：
   • Windows（cmd）：

     venv\Scripts\activate.bat
     

   • Windows（PowerShell）：

     venv\Scripts\Activate.ps1
     

   • Linux/macOS：

     source venv/bin/activate
     

4. 一键安装所有依赖：用导出的requirements.txt批量安装包

   pip install -r requirements.txt
   

5. 启动应用：直接运行项目的启动脚本，比如：

   python app.py
   

要不要写.bat文件？ #

如果想让完全不懂命令行的人一键操作，写个简单的.bat（Windows）或shell脚本（Linux/macOS）是可行的，但新手没必要一开始就折腾这个——上面的步骤已经足够简单，手动操作还能让你更清楚每一步的作用，避免脚本出问题时找不到原因。

如果确实需要Windows的.bat示例，参考这个（放在项目根目录）：

@echo off
echo 创建虚拟环境...
python -m venv venv
echo 激活虚拟环境...
call venv\Scripts\activate.bat
echo 安装依赖...
pip install -r requirements.txt
echo 启动应用...
python app.py
pause

注意：如果对方机器的Python命令是python3而非python，这个脚本会报错，所以手动操作反而更灵活。

新手注意事项 #

• 确保其他机器安装了和你本地一致的Python版本，避免依赖兼容问题
• 必须使用虚拟环境，不然会污染系统全局的Python环境
• 提交requirements.txt到Git时，别把本地的venv文件夹也提交——在.gitignore里加一行venv/，Git会自动忽略这个文件夹

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