Ubuntu 24.04.3 LTS 配置 Git 并连接 GitHub
在 Ubuntu 24.04.3 LTS 系统中完成 Git 的安装与基础配置，实现本地 Git 与 GitHub 远程仓库的安全连接，支持代码的克隆、提交、推送等核心操作，为日常开发和版本管理提供稳定的环境。
前置条件
- 已安装 Ubuntu 24.04.3 LTS 系统，且具备 sudo 权限；
- 系统可正常访问外网（需确保能连通 GitHub 服务器）；
- 已注册 GitHub 账号。
一、安装 Git
Ubuntu 24.04.3 LTS 自带软件源包含 Git，可直接通过 apt 安装，步骤如下：
1. 更新系统软件源
首先更新本地软件包索引，确保安装的是最新版本的 Git：
sudo apt update
2. 安装 Git
执行以下命令安装 Git：
sudo apt install git -y
3. 验证 Git 安装
安装完成后，检查 Git 版本以确认安装成功：
git --version
若输出类似 git version 2.43.0（版本号可能因系统更新略有差异），则说明安装成功。
二、配置 Git 全局基础信息
Git 需要配置用户名和邮箱，用于标识提交者身份（建议与 GitHub 账号的用户名、邮箱一致）：
1. 配置用户名
将 <Your_GitHub_Username> 替换为你的 GitHub 用户名：
git config --global user.name "Your_GitHub_Username"
2. 配置邮箱
将 <Your_GitHub_Email> 替换为你的 GitHub 注册邮箱：
git config --global user.email "[email protected]"
3. 验证配置
执行以下命令查看已配置的信息：
git config --list
输出中若包含 user.name=你的用户名 和 user.email=你的邮箱，则配置生效。
三、配置 Git 与 GitHub 的连接方式
Git 连接 GitHub 有两种主流方式：SSH 方式（推荐，免重复输入密码）和 HTTPS 方式（需每次输入令牌/密码，适合临时使用），以下优先讲解 SSH 方式。
方式 1：SSH 连接（推荐）
SSH 连接通过密钥对认证，无需每次输入账号密码，是最常用的方式。
1. 生成 SSH 密钥对
执行以下命令生成 SSH 密钥（默认算法为 ed25519，安全性更高）：
ssh-keygen -t ed25519 -C "[email protected]"
执行后会出现以下交互提示，全部按回车默认即可（此种情况默认不设置密码）：
Enter file in which to save the key (/home/你的用户名/.ssh/id_ed25519):：回车，使用默认路径；Enter passphrase (empty for no passphrase):：回车（可选设置密码，每次使用密钥时需验证，增加安全性）；Enter same passphrase again:：回车（若上一步设置了密码，需重复输入）。
生成完成后，密钥对会保存在 ~/.ssh/ 目录下：
- 私钥：
id_ed25519（切勿泄露给他人）； - 公钥：
id_ed25519.pub（需添加到 GitHub）。
2. 将公钥添加到 GitHub 账户
步骤 1：查看并复制公钥内容
执行以下命令查看公钥内容：
cat ~/.ssh/id_ed25519.pub
复制输出的全部内容（以 ssh-ed25519 开头，以你的邮箱结尾）。
步骤 2：在 GitHub 中添加公钥
- 登录 GitHub 账号，点击右上角头像 →
Settings（设置）； - 在左侧菜单栏找到
SSH and GPG keys→ 点击New SSH key； - 填写信息：
Title：自定义名称（如Ubuntu 24.04 Git）；Key type：选择Authentication Key；Key：粘贴刚才复制的公钥内容；
- 点击
Add SSH key，输入 GitHub 密码验证后完成添加。
3. 验证 SSH 连接
执行以下命令测试与 GitHub 的 SSH 连接：
ssh -T [email protected]
首次连接会提示 Are you sure you want to continue connecting (yes/no/[fingerprint])?，输入 yes 回车。
若输出 Hi Your_GitHub_Username! You've successfully authenticated, but GitHub does not provide shell access.，则说明 SSH 连接配置成功。
方式 2：HTTPS 连接（备用）
若因网络/权限问题无法使用 SSH，可选择 HTTPS 方式，需配置凭证缓存避免重复输入密码。
1. 配置 Git 凭证缓存
执行以下命令设置凭证缓存（缓存时间 1 小时，单位：秒）：
git config --global credential.helper 'cache --timeout=3600'
2. 验证 HTTPS 连接
克隆一个公开仓库测试（替换为你的仓库地址）：
git clone https://github.com/Your_GitHub_Username/your-repo.git
首次克隆会提示输入 GitHub 用户名和个人访问令牌（PAT）（GitHub 已不再支持密码登录），输入后即可完成克隆。
注：个人访问令牌（PAT）需在 GitHub 中生成：Settings → Developer settings → Personal access tokens → Generate new token，勾选
repo权限，生成后保存好（仅显示一次）。
四、测试 Git 操作（以 SSH 方式为例）
1. 克隆远程仓库
git clone [email protected]:Your_GitHub_Username/your-repo.git
2. 本地修改并提交
# 进入克隆的仓库目录
cd your-repo
# 创建测试文件
touch test.txt
# 将文件加入暂存区
git add test.txt
# 提交修改
git commit -m "Add test file"
# 推送到 GitHub 远程仓库
git push origin main
若推送成功，说明整个配置流程完成。
五、常见问题及解决
1. SSH 连接提示 'Permission denied (publickey)'
- 检查公钥是否正确添加到 GitHub，确保复制的是
id_ed25519.pub完整内容； - 检查私钥权限（需设置为 600）：
chmod 600 ~/.ssh/id_ed25519； - 重启 SSH 代理：
eval "$(ssh-agent -s)"→ssh-add ~/.ssh/id_ed25519。
2. Git push 提示 'fatal: Could not read from remote repository'
- 确认远程仓库地址正确（SSH 地址以
[email protected]:开头，HTTPS 以https://github.com/开头）； - 检查网络是否能访问 GitHub：
ping github.com（若不通，可配置国内镜像或代理）。
3. Ubuntu 安装 Git 提示 'Package git is not available'
- 执行
sudo apt update刷新软件源，或更换国内镜像源（如阿里云、清华源）后再安装。
总结
- Ubuntu 24.04.3 LTS 下安装 Git 优先使用
apt命令，简单且稳定； - Git 与 GitHub 连接优先选择 SSH 方式，需生成密钥对并将公钥添加到 GitHub，验证连接后即可免密操作；
- 核心配置步骤：安装 Git → 配置用户名/邮箱 → 配置连接方式（SSH/HTTPS）→ 测试克隆/推送。
通过以上步骤，你已完成 Ubuntu 24.04.3 LTS 与 GitHub 的 Git 环境配置，可正常进行代码的版本管理和远程同步。
