下面我给你一份 真正完整、从零到能 push 代码的 GitHub + Git 配置详细教程。

不废话，直接从你电脑环境开始，一步一步做到能顺利提交代码。

🚀 一、安装 Git（如果你已经安装可跳过）

Windows

去官网下载安装包：
https://git-scm.com/download/win

安装时保持默认即可。

macOS

系统自带 Git，也可以用 Homebrew 更新：

brew install git

Linux

Ubuntu：

sudo apt install git

二、本地 Git 全局配置（必须）

Git 第一次使用必须告诉它你是谁：

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

查看是否设置成功：

git config --list

🔐 三、配置 SSH 密钥（最推荐方式）

SSH 是 GitHub 最稳定、最省心的连接方式。

1. 生成 SSH Key

打开终端输入：

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

一路回车即可。

2. 查看公钥内容

cat ~/.ssh/id_ed25519.pub

复制输出的整段内容。

3. 添加到 GitHub

GitHub → 右上角头像 → Settings → SSH and GPG keys → New SSH key

把公钥粘贴进去。

4. 测试是否成功

ssh -T git@github.com

看到：

Hi xxx! You've successfully authenticated

就成功了。

四、GitHub 仓库设置（两种情况）

情况 A：你要把本地项目上传到 GitHub

1. 在 GitHub 创建一个新仓库

GitHub → New repository → 填名字 → Create。

2. 在本地项目目录执行：

git init
git add .
git commit -m "first commit"

3. 绑定远程仓库（SSH 方式）

git remote add origin git@github.com:你的用户名/仓库名.git

4. 推送代码

git push -u origin main

如果你的默认分支是 master：

git push -u origin master

情况 B：你要从 GitHub 克隆项目到本地

git clone git@github.com:用户名/仓库名.git

进入目录：

cd 仓库名

五、日常 Git 操作（最常用）

1. 查看文件状态

git status

2. 添加文件

git add .

3. 提交

git commit -m "描述本次修改"

4. 推送

git push

5. 拉取更新

git pull

六、分支管理（常用）

创建分支

git branch dev

切换分支

git checkout dev

创建并切换

git checkout -b dev

合并分支

切到 main：

git checkout main
git merge dev