跳到主要内容Ubuntu 24.04.3 LTS 配置 Git 并连接 GitHub | 极客日志Shell / Bash
Ubuntu 24.04.3 LTS 配置 Git 并连接 GitHub
介绍在 Ubuntu 24.04.3 LTS 系统下安装 Git 并配置连接 GitHub 的方法。内容包括更新软件源、安装 Git、配置全局用户名和邮箱、生成 SSH 密钥对并添加到 GitHub 账户、验证连接以及测试克隆和推送操作。同时提供了 HTTPS 连接方式的备选方案及常见问题解决方案,帮助开发者建立稳定的版本管理环境。
HadoopMan3 浏览 Ubuntu 24.04.3 LTS 配置 Git 并连接 GitHub
目的
在 Ubuntu 24.04.3 LTS 系统中完成 Git 的安装与基础配置,实现本地 Git 与 GitHub 远程仓库的安全连接,支持代码的克隆、提交、推送等核心操作,为日常开发和版本管理提供稳定的环境。
前置条件
- 已安装 Ubuntu 24.04.3 LTS 系统,且具备 sudo 权限(普通用户可执行管理员命令);
- 系统可正常访问外网(需连接 GitHub 服务器);
- 已注册 GitHub 账号(未注册可前往 GitHub 官网 完成注册);
一、安装 Git
Ubuntu 24.04.3 LTS 自带软件源包含 Git,可直接通过 apt 安装,步骤如下:
1. 更新系统软件源
首先更新本地软件包索引,确保安装的是最新版本的 Git:
2. 安装 Git
3. 验证 Git 安装
若输出类似 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 注册邮箱:
3. 验证配置
输出中若包含 user.name=你的用户名 和 user.email=你的邮箱,则配置生效。
三、配置 Git 与 GitHub 的连接方式
Git 连接 GitHub 有两种主流方式:SSH 方式(推荐,免重复输入密码)和 HTTPS 方式(需每次输入令牌/密码,适合临时使用),以下优先讲解 SSH 方式。
方式 1:SSH 连接(推荐)
SSH 连接通过密钥对认证,无需每次输入账号密码,是最常用的方式。
1. 生成 SSH 密钥对
执行以下命令生成 SSH 密钥(默认算法为 ed25519,安全性更高):
ssh-keygen -t ed25519 -C "Your_GitHub_Email@example.com"
执行后会出现以下交互提示,全部按回车默认即可(此种情况默认不设置密码):
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 连接:
首次连接会提示 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. 克隆远程仓库
2. 本地修改并提交
cd your-repo
touch test.txt
git add test.txt
git commit -m "Add test file"
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 环境配置,可正常进行代码的版本管理和远程同步。
微信扫一扫,关注极客日志
微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
相关免费在线工具
- Base64 字符串编码/解码
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
- Base64 文件转换器
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
- Markdown转HTML
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online
- HTML转Markdown
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online
- JSON 压缩
通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online
- JSON美化和格式化
将JSON字符串修饰为友好的可读格式。 在线工具,JSON美化和格式化在线工具,online