将项目文件夹推送至GitHub的最佳方法及Python自动化脚本实现步骤咨询

前置检查 #

• 确保本地已安装Git，执行git --version验证，返回版本号即为安装正常
• 已在Git托管平台（GitHub/GitLab/Gitee等）创建对应的空远程仓库
• 本地Git已配置用户信息，未配置可执行以下命令设置：
  • git config --global user.name "你的平台用户名"
  • git config --global user.email "你的平台绑定邮箱"
• 建议在项目根目录新增.gitignore文件，过滤Python项目无需提交的缓存、环境文件，参考内容：

__pycache__/
*.py[cod]
*$py.class
.venv/
venv/
.env
.idea/
.vscode/
*.log

脚本实现核心流程 #

核心逻辑为固定的Git操作链路，首次执行会完成仓库初始化与远程绑定，后续执行直接提交推送即可：

1. 进入项目根目录
2. 检查是否已初始化Git仓库，未初始化则执行git init并绑定远程仓库地址
3. 拉取远程分支最新代码，避免本地与远程冲突
4. 将所有变更文件加入暂存区
5. 提交变更，可搭配时间戳生成自动提交信息
6. 推送至远程对应分支

可直接使用的脚本示例 #

Shell脚本（适用于macOS/Linux） #

#!/bin/bash
# 以下配置项替换为你自己的内容
PROJECT_PATH="/home/xxx/你的项目根目录绝对路径"
BRANCH_NAME="main" # 部分仓库主分支名为master，自行修改
REMOTE_URL="https://gitee.com/xxx/你的仓库名.git"

cd $PROJECT_PATH || exit

# 首次执行初始化Git
if [ ! -d ".git" ]; then
  git init
  git remote add origin $REMOTE_URL
fi

# 拉取最新代码
git pull origin $BRANCH_NAME
# 添加所有变更
git add .
# 提交代码，可自定义提交信息
git commit -m "自动提交: $(date +'%Y-%m-%d %H:%M:%S')"
# 推送到远程
git push origin $BRANCH_NAME

使用方法：

• 保存为git_push.sh
• 执行chmod +x git_push.sh添加执行权限
• 直接运行./git_push.sh即可完成推送

Python脚本（跨平台通用） #

import os
from datetime import datetime

# 以下配置项替换为你自己的内容
PROJECT_PATH = r"C:\Users\xxx\你的项目根目录绝对路径" # Windows路径加r前缀避免转义问题
BRANCH_NAME = "main"
REMOTE_URL = "https://gitee.com/xxx/你的仓库名.git"

os.chdir(PROJECT_PATH)

# 首次执行初始化Git
if not os.path.exists(".git"):
    os.system("git init")
    os.system(f"git remote add origin {REMOTE_URL}")

# 拉取最新代码
os.system(f"git pull origin {BRANCH_NAME}")
# 添加所有变更
os.system("git add .")
# 提交代码
commit_msg = f"自动提交: {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}"
os.system(f'git commit -m "{commit_msg}"')
# 推送到远程
os.system(f"git push origin {BRANCH_NAME}")

使用方法：保存为git_push.py后直接运行即可。

常见问题排查 #

• 提示remote origin already exists：执行git remote set-url origin 你的新远程仓库地址更新绑定即可
• 推送提示冲突：手动解决冲突文件后重新运行脚本即可
• 每次运行需要输入账号密码：配置SSH密钥绑定到Git平台即可实现免密推送

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