Ubuntu 26.04 安装与配置 Git 完整教程（新手一步到位）

运维工作中的基础操作。这篇文章用最直白的步骤，带你从安装到配置一气呵成，全程无报错、无多余依赖，直接复制命令即可使用。同时汇总日常开发高频常用 Git 命令，满足日常代码提交、分支管理、版本回退等所有场景。

首先我们先更新一下系统软件源，安装工具前更新源可以有效避免依赖缺失、软件版本过旧等问题，执行下面命令即可：

安装任何工具前先更新源，能避免出现依赖缺失、版本过旧的问题。

sudo apt update && sudo apt upgrade -y

源更新完成后，就可以直接安装 Git 了。Ubuntu 26.04 的官方软件源自带稳定新版 Git，无需额外添加第三方源，直接一键安装：

Ubuntu 26.04 官方源已自带最新稳定版 Git，直接安装即可。

sudo apt install git -y

安装完成后验证版本：

git --version

出现类似git version 2.53.x 字样，说明安装成功。

安装完成后一定要做基础用户配置，这一步是必须的！Git 每次提交代码都会标记提交者信息，不配置的话无法正常提交代码。

Git 提交代码时需要标识用户信息，否则无法正常提交。

设置用户名：

git config --global user.name "你的名字"

设置邮箱（建议与代码平台邮箱一致，如 Gitee / GitHub）：

git config --global user.email "your@email.com"

查看当前配置：

git config --list

基础配置完成后，推荐做几项优化配置，适配日常开发场景，解决换行符兼容、命令显示、默认分支命名等小问题：

让命令输出更清晰、解决换行符兼容问题、设置默认主分支名称。

git config --global color.ui auto
git config --global core.autocrlf input
git config --global init.defaultBranch main

为了后续拉取、推送代码不用重复输入账号密码，这里推荐配置 SSH 密钥实现免密登录，适配 GitHub、Gitee 等所有代码托管平台。

1、首先生成 SSH 密钥，执行以下命令，生成时连续三次回车，默认路径、不设置密码即可：

使用 SSH 可以免密拉取、推送代码，避免每次输入账号密码，提升开发效率。

1. 生成密钥

ssh-keygen -t ed25519 -C "your@email.com"

连续回车三次，使用默认路径和无密码模式即可。

cat ~/.ssh/id_ed25519.pub

2、密钥生成完成后，查看并复制公钥：

将输出的一长串内容复制，粘贴到代码平台的 SSH Keys 中。

ssh -T git@gitee.com

3、将复制的公钥粘贴到代码平台的 SSH 密钥配置中，随后测试连接（以 Gitee 为例），出现成功提示即配置完成：

出现成功提示即配置完成。

进入项目目录，初始化 Git 仓库并完成首次提交。

配置全部完成后，我们就可以在本地项目中初始化 Git 仓库，完成首次代码提交，新手直接复制以下命令即可：

# 初始化本地git仓库
git init

# 添加所有文件到暂存区
git add .

# 提交暂存区代码到本地仓库
git commit -m "初始化项目"

本节分类汇总 克隆拉取、提交推送、分支管理、版本回退、日志查看、远程仓库 全场景常用命令，开箱即用，适配 Ubuntu 系统所有 Git 操作。

最后整理一份自己日常开发一直在用的 Git 高频命令，涵盖克隆拉取、代码提交、分支管理、版本回退、日志查看、标签管理等全场景，不用每次都去网上搜，收藏这篇就够了。

1、仓库克隆与代码拉取

1. 仓库克隆与拉取

# 克隆远程仓库到本地
git clone 仓库地址

# 拉取远程仓库最新代码（不合并）
git fetch

# 拉取并合并远程最新代码（常用）
git pull

# 添加单个文件到暂存区
git add 文件名

# 添加所有修改、新增文件到暂存区
git add .

# 提交代码并填写备注
git commit -m "提交备注信息"

# 修改上一次提交的备注（不新增提交记录）
git commit --amend

# 暂存当前工作区修改（临时保存，切换分支专用）
git stash

# 恢复最近一次暂存的代码
git stash pop

# 查看所有暂存记录
git stash list

2、文件提交与代码暂存

# 查看本地所有分支
git branch

# 查看本地+远程所有分支
git branch -a

# 创建新分支
git branch 分支名

# 切换到指定分支
git checkout 分支名

# 创建并切换到新分支（一步到位）
git checkout -b 分支名

# 合并指定分支到当前分支
git merge 分支名

# 删除本地分支
git branch -d 分支名

# 强制删除本地分支（未合并分支）
git branch -D 分支名

# 删除远程分支
git push origin --delete 分支名

3、核心分支管理操作

# 查看远程仓库关联信息
git remote -v

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

# 修改远程仓库地址
git remote set-url origin 新仓库地址

# 推送本地分支到远程仓库
git push origin 分支名

# 强制推送（谨慎使用，会覆盖远程代码）
git push origin 分支名 --force

4、远程仓库关联与推送

# 撤销工作区所有修改（未add）
git checkout .

# 撤销指定文件修改
git checkout 文件名

# 取消暂存（已add，未commit）
git reset HEAD .

# 回退到上一个版本（保留代码修改）
git reset --soft HEAD~1

# 回退到上一个版本（清空所有修改，谨慎使用）
git reset --hard HEAD~1

# 回退到指定commit版本
git reset --hard 版本号

5、版本回退与代码撤销（谨慎使用硬回退）

# 查看简易提交日志
git log

# 单行简洁查看所有提交记录
git log --oneline

# 查看详细修改记录
git log -p

# 查看当前文件状态
git status

# 查看文件修改详情
git diff

6、日志与文件状态查看

# 查看所有标签
git tag

# 创建轻量标签
git tag v1.0.0

# 创建带备注标签
git tag -a v1.0.0 -m "版本1.0.0发布"

# 推送单个标签到远程
git push origin v1.0.0

# 推送所有标签
git push origin --tags

# 删除本地标签
git tag -d v1.0.0

# 删除远程标签
git push origin :v1.0.0

7、版本标签管理（项目发布专用）

如需卸载系统 Git，执行以下命令彻底卸载，无残留配置。

sudo apt remove --purge git -y
sudo apt autoremove -y

如果后续不需要 Git 工具了，可以执行以下命令彻底卸载，清除所有配置残留，干净无冗余：

本文完整覆盖 Ubuntu 26.04 系统下 Git 的 安装、环境配置、SSH免密登录、项目初始化、高频命令 全流程，所有命令经过适配验证，桌面版、服务器版均可直接使用。收藏本文，日常开发、服务器部署 Git 操作无需再查其他文档。