Ubuntu 26.04 推送本地 Git 仓库到远程仓库

今天分享一套 Ubuntu26.04 专属的实操流程,手把手教大家把本地的 Git 仓库,完整推送到 Gitee、GitHub 这类远程代码仓库。全程都是日常自用的最简操作,没有复杂理论,零基础也能直接照着复制命令执行,一次就能成功上传本地代码。

首先我们要提前准备好基础环境,如果你的系统还没安装 Git、没有配置用户信息,先执行这几条命令初始化,只需要配置一次,后续永久生效。先更新软件源安装 Git,再配置全局用户名和邮箱,这是提交、推送代码的必要前提,不配置会直接报错。

sudo apt update && sudo apt install git -y
git config --global user.name "自定义用户名"
git config --global user.email "你的注册邮箱"

很多新手容易忽略一个前提:想要推送的文件夹,必须是一个初始化完成的 Git 本地仓库。如果只是普通文件夹,直接推送会失败。我们先进入项目目录,完成初始化、添加文件、本地提交这三步基础操作,确保本地仓库是完整可用的状态。

# 进入你的项目文件夹
cd ~/你的项目文件夹
# 初始化本地Git仓库
git init
# 添加所有文件到暂存区
git add .
# 本地首次提交
git commit -m "初始化项目,首次本地提交"

本地仓库准备完成后,我们打开 Gitee 或者 GitHub 官网,手动新建一个空的远程仓库。这里有一个非常关键的避坑点:新建远程仓库时,千万不要勾选自动创建 README、开源协议、.gitignore 文件。如果远程仓库自带文件,本地首次推送会直接报冲突错误,导致推送失败,保持仓库完全空白即可。

空白远程仓库创建完成后,页面会提供两种仓库地址,分别是 HTTPS 和 SSH 地址。简单说下两者的区别,方便大家按需选择:临时偶尔推送、不想配置密钥就用 HTTPS;长期开发、频繁推拉代码,推荐配置 SSH 密钥,后续不用重复输入账号密码,更稳定高效。

接下来就是核心步骤,将本地仓库和远程仓库进行关联。复制好你的远程仓库地址,在终端执行关联命令,这一步是打通本地和远程的关键。

# 关联远程仓库
git remote add origin 你的远程仓库地址

关联完成后,可以执行查看命令校验是否成功,能看到 fetch、push 两行地址信息,就代表关联正常。

git remote -v

如果不小心关联错了仓库地址,不用慌,直接执行命令覆盖修改即可,不用重新初始化仓库:

git remote set-url origin 新的远程仓库地址

关联成功后,就可以推送代码到远程仓库了。首次推送必须携带 -u 参数,作用是绑定本地分支和远程分支,绑定之后,后续再次推送代码,直接输入简单命令即可,不用重复填写分支信息。大部分新仓库默认主分支是 main,如果你的仓库是老版本 master 分支,对应修改即可。

# 首次推送,绑定分支
git push -u origin main

# 后续日常推送,直接使用
git push

日常开发迭代中,我们修改代码、新增文件后,固定一套极简推送流程即可,先添加文件、提交备注,再推送远程,简单高效不出错。

git add .
git commit -m "更新:修复bug/新增功能/优化内容"
git push

如果是多人协作开发,一定要养成先拉取最新代码、再推送的习惯,避免本地代码和远程代码出现冲突,导致推送失败。

git pull
git push

另外补充一个慎用的命令,强制推送。只有单人开发、确定本地代码是最新完整版,需要覆盖远程错误代码时再使用,多人协作场景绝对禁止,会覆盖他人提交的代码,造成数据丢失。

git push --force

最后整理几个新手最高频的报错和解决办法,都是实操中经常遇到的问题。

一是推送提示 Everything up-to-date,这不是报错,只是说明本地没有新的提交,先执行 add 和 commit 保存修改,再推送即可。

二是远程存在本地没有的文件,推送被拒绝,这就是之前说的新建仓库自带文件导致的冲突,执行拉取合并命令后再推送就能解决。

git pull --rebase
git push

三是 HTTPS 方式每次推送都要输入账号密码,可以配置凭证缓存,保存一次后永久免输密码。

git config --global credential.helper store

整体流程非常简单,总结下来就是:安装配置Git – 本地初始化提交 – 新建空白远程仓库 – 关联远程地址 – 首次绑定推送 – 日常一键更新。这套流程适配 Ubuntu26.04 所有桌面版和服务器版,日常个人开发、代码备份、项目归档完全够用。

本文首发于 58Linux技术博客,专注Ubuntu桌面使用、Linux服务器运维与网站搭建实战。

发表评论

粤ICP备10052831号 | © 2026 58Linux 技术笔记. All Rights Reserved. | 联系我们 | 关于本站
本站内容开放共享,仅供学习交流 | 专注 Ubuntu & Linux 实战教程
Built with GeneratePress