Git 本地仓库推送到远程空仓库指南
本文档介绍如何将本地 Git 仓库推送到远程空仓库的完整流程。
前提条件
- 本地已有一个 Git 仓库
- 已创建远程空仓库（如 GitLab、GitHub 等）
- 已配置 Git 用户信息
操作步骤
1. 检查当前远程仓库配置
bash
git remote -v说明：
- 查看当前配置的远程仓库信息
- 如果没有配置远程仓库，会显示为空
2. 设置远程仓库地址
bash
git remote set-url origin <远程仓库URL>示例：
bash
git remote set-url origin https://gitlab.com/QIU_STUDY/ac6965a_sdk_cplus_tflm_kws.git说明：
origin是远程仓库的默认别名- 将
<远程仓库URL>替换为你的实际远程仓库地址
3. 确认远程仓库配置
bash
git remote -v说明：
- 再次检查远程仓库配置是否正确
- 确认 fetch 和 push 地址都已更新
4. 查看当前分支
bash
git branch说明：
- 查看当前所在分支
- 带
*号的分支是当前活动分支
5. 推送所有分支并设置上游
bash
git push --set-upstream origin --all说明：
--all：推送所有本地分支到远程仓库--set-upstream origin：设置上游分支为 origin- 这个命令会推送所有分支并自动设置跟踪关系
6. 推送所有标签并设置上游
bash
git push --set-upstream origin --tags说明：
--tags：推送所有本地标签到远程仓库--set-upstream origin：设置上游分支为 origin
完整操作示例
bash
# 1. 检查远程仓库配置
git remote -v
# 输出示例：
# origin https://gitlab.com/QIU_STUDY/ac6965a_sdk_cplus_tflm_kws.git (fetch)
# origin https://gitlab.com/QIU_STUDY/ac6965a_sdk_cplus_tflm_kws.git (push)
# 2. 设置远程仓库地址
git remote set-url origin https://gitlab.com/QIU_STUDY/ac6965a_sdk_cplus_tflm_kws.git
# 3. 确认配置
git remote -v
# 4. 查看分支
git branch
# 输出示例：
# * master
# 5. 推送所有分支
git push --set-upstream origin --all
# 输出示例：
# Enumerating objects: 18781, done.
# Counting objects: 100% (18781/18781), done.
# Delta compression using up to 22 threads
# Compressing objects: 100% (11690/11690), done.
# Writing objects: 100% (18781/18781), 300.85 MiB | 200.43 MiB/s, done.
# Total 18781 (delta 6018), reused 18618 (delta 5947), pack-reused 0 (from 0)
# remote: Resolving deltas: 100% (6018/6018), done.
# To https://gitlab.com/QIU_STUDY/ac6965a_sdk_cplus_tflm_kws.git
# * [new branch] master -> master
# branch 'master' set up to track 'origin/master'.
# 6. 推送所有标签
git push --set-upstream origin --tags
# 输出示例：
# Enumerating objects: 94, done.
# Counting objects: 100% (94/94), done.
# Delta compression using up to 22 threads
# Compressing objects: 100% (48/48), done.
# Writing objects: 100% (51/51), 13.26 MiB | 53.05 MiB/s, done.
# Total 51 (delta 34), reused 17 (delta 0), pack-reused 0 (from 0)
# To https://gitlab.com/QIU_STUDY/ac6965a_sdk_cplus_tflm_kws.git
# * [new tag] feature_自定义flash区读写文件 -> feature_自定义flash区读写文件
# * [new tag] 自定义flash区读写文件 -> 自定义flash区读写文件注意事项
- 仓库大小：如果仓库很大，推送可能需要较长时间
- 权限验证：确保有远程仓库的推送权限
- 网络连接：确保网络连接稳定
- 分支管理：推送前确认不需要推送的分支已删除
- 敏感信息：推送前检查是否有敏感信息被意外提交
常见问题
Q: 推送失败，提示 "non-fast-forward"
A: 远程仓库可能已有内容，需要先拉取合并或强制推送
Q: 推送失败，提示权限不足
A: 检查远程仓库的访问权限和认证信息
Q: 推送大文件失败
A: 检查远程仓库对大文件的限制，或使用 Git LFS
相关命令
git remote add origin <URL>：添加远程仓库（如果还没有）git push origin <branch>：推送特定分支git push --force：强制推送（谨慎使用）git pull --rebase：拉取并变基合并