Ubuntu 安装 Git + 完整上传代码教程（SSH 免密方式，推荐 Gitee/GitHub）

一、安装 Git

打开终端执行更新 + 安装命令

bash

运行

# 更新软件源索引 sudo apt update # 安装git，-y自动确认 sudo apt install git -y

验证安装是否成功（输出版本号即成功）：

bash

运行

git --version

Windows上的Git身份配置不会自动生效于Ubuntu系统，因为两个系统的配置文件是相互独立的。

你不需要想新名字，直接在Ubuntu里重新配置一遍完全相同的用户名和邮箱就行。这并不会冲突，反而能保证你在两台电脑上的提交记录是关联的。

二、全局配置 Git 用户名、邮箱（必须，对应代码托管平台账号）

bash

运行

# 替换成你Gitee/GitHub的用户名 git config --global user.name "你的用户名" # 替换成注册平台的邮箱 git config --global user.email "你的注册邮箱"

查看配置：

bash

运行

git config --global --list

三、生成 SSH 密钥（免密上传，不用每次输账号密码）

1. 生成密钥

bash

运行

ssh-keygen -t ed25519 -C "你的注册邮箱"

执行后连续三次回车：

1. 存储路径默认回车
2. 密钥密码回车（不设置）
3. 确认密码回车

2. 查看并复制公钥

bash

运行

cat ~/.ssh/id_ed25519.pub

复制终端输出全部内容（以ssh-ed25519开头，邮箱结尾）。

3. 公钥添加到代码平台（以 Gitee 为例，GitHub 操作类似）

1. 登录 Gitee → 右上角头像 →设置
2. 左侧菜单找到SSH 公钥
3. 标题随便填（如 Ubuntu 主机），把复制的公钥完整粘贴到 Key 框，保存
4. 验证连接

bash

运行

# Gitee测试 ssh -T git@shturl.cc # GitHub测试 ssh -T git@github.com

出现Hi xxx! You've successfully authenticated代表密钥配置完成。

四、上传本地代码到远程仓库完整流程

前置操作：网页端新建空仓库

登录 Gitee/GitHub，新建仓库，不要勾选初始化 README，复制仓库 SSH 地址，格式示例：git@shturl.cc:用户名/项目名.git

步骤 1：进入本地项目文件夹

bash

运行

cd /home/xxx/你的代码文件夹

步骤 2：初始化本地 Git 仓库

bash

运行

git init

步骤 3：将所有文件加入暂存区

bash

运行

# 添加当前目录全部文件 git add . # 只添加单个文件：git add test.c

步骤 4：提交到本地仓库（-m 填写提交备注）

bash

运行

git commit -m "首次上传：完整项目代码"

在首次上传时需要再次输入

步骤 5：关联远程仓库（粘贴刚才复制的 SSH 地址）

bash

运行

git remote add origin git@shturl.cc:用户名/项目名.git

查看远程关联：git remote -v

SSH 地址格式不能带 https://gitee.com/，正确 SSH 格式是：
git@gitee.com:用户名/仓库名.git
你拼接了 https:// 进去，地址非法，后续连接必然异常。

步骤 6：推送代码到远程（上传）

Ubuntu 新版 git 默认分支为 main

bash

运行

git push -u origin main

旧系统分支名为 master 则执行：git push -u origin master

补充：常用辅助命令

1. 查看文件修改状态：git status
2. 查看提交记录：git log
3. 拉取远程最新代码：git pull
4. 取消暂存文件：git reset .

简易 HTTP 方式（无需 SSH 密钥，每次推送输账号密码）

关联远程仓库用 https 地址：

bash

运行

git remote add origin shturl.cc/VnQZY9WI用户名/项目名.git git push origin main

推送时会弹窗输入平台账号、个人令牌（Gitee/GitHub 现已不支持密码登录，需生成 token）。