GitPython push失败却无报错，常见因远程已同步（PUSH_STATUS_UP_TO_DATE），需检查push_info.flags & PushInfo.ERROR；add后未跟踪文件多因路径错误或被.gitignore排除；初始化权限错误实为路径冲突或格式不当；推送后GitHub无更新常因分支名不匹配或默认分支设置错误。
gitpython push 失败但没报错，本地 commit 成功了
常见现象是 repo.index.commit() 走过，origin.push() 返回一个 PushInfo 对象，但 push_info.summary 为空、push_info.flags 是 PUSH_STATUS_UP_TO_DATE ——其实根本没推，只是本地分支和远程一致而已。真正要检查是否成功，得看 push_info.flags & PushInfo.ERROR 是否为真，或者直接打印 push_info.flags 的整数值（比如 16 表示拒绝，4 表示快进失败）。
- 确保远程分支名明确：用
origin.push('main:main')而不是只写origin.push('main')，后者在某些 Git 配置下会 fallback 到 refspec 不匹配 - 如果远程仓库需要 token 认证（比如 GitHub），URL 必须带凭证：
https://<user>:<token>@github.com/user/repo.git</token></user>；用 SSH 路径则需提前配置好 ssh-agent -
origin.push()默认不强制，遇到非快进更新（比如远程有你没有的提交）会静默失败，加force=True参数前先确认必要性
gitpython add 后文件没被 track，commit 提交空内容
典型原因是调用了 repo.index.add() 但传入路径错误：它接受的是工作区相对路径（如 ['src/main.py']），不是绝对路径，也不是 glob 模式。如果你传了 ['*.py'] 或 ['/home/u/project/src/main.py']，GitPython 不报错，但实际什么都没加。
- 确认文件确实存在且未被
.gitignore排除：用repo.git.check_ignore('src/main.py')测试，有输出说明被忽略 - 批量添加推荐用
repo.git.add('--all')（绕过 index.add 的路径限制），或先repo.git.ls_files('--others', '--exclude-standard')拿到待跟踪列表再逐个add() -
repo.index.add()不会自动递归子目录，['src']不等于src/**；要加整个目录得自己 walk + 过滤
gitpython 初始化仓库时 PermissionError: [Errno 13] Permission denied
不是权限不够，而是目标路径已被占用：比如该路径下已有同名文件（非目录），或者上层目录不可写但 GitPython 尝试创建空目录失败。更隐蔽的情况是路径末尾多了斜杠（'./myrepo/'），Repo.init() 会把它当文件处理。
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
- 初始化前先清理：用
os.path.exists()和os.path.isdir()双重判断路径状态，避免覆盖文件 - 不要用相对路径开头的点号（
./）或波浪号（~/），Repo.init()不做 shell 展开，直接传os.path.expanduser('~/myrepo') - Windows 下注意路径分隔符，
os.path.join()比硬写'a\b\c'更可靠
GitHub 上传后看不到新 commit，但 gitpython 显示 push 成功
大概率是推送到了错误分支，或远程默认分支不是你认为的那个。GitHub 新仓库默认主分支名是 main，但旧项目可能是 master；而 origin.push() 如果不指定 refspec，默认按本地当前分支名推送到同名远程分支——如果你本地是 dev 分支，却以为推到了 main，就会发现 GitHub 页面没更新。
立即学习“Python免费学习笔记（深入）”；
- 推送前查清楚：用
repo.active_branch.name看当前分支，用origin.refs查远程有哪些分支可推 - 显式指定 refspec 最安全：
origin.push(refspec='HEAD:main')或origin.push(refspec='dev:main') - GitHub 仓库设置里「Default branch」必须和你 push 的目标分支一致，否则 PR/主页展示不会自动切过去
最麻烦的其实是 GitPython 对 submodule、large file（LFS）、cherry-pick 后的冲突状态不敏感，这些场景下看似 push 成功，实际远程历史可能断裂。真要稳定自动化，建议关键步骤后补一句 repo.git.log('-n', '1', '--oneline') 核对 HEAD，别全信 PushInfo 的 flag。
