菜单
文章 Tools

Git 入门教程：本地连接 GitHub 并掌握基础操作

UP

UP

• 阅读本文需 4 分钟

Git 是目前最流行的版本控制工具，而 GitHub 是最常用的远程代码托管平台。学会用 Git 将本地项目推送到 GitHub，不仅能备份代码，还能方便协作、展示作品。本文将手把手教你从零开始配置 Git、连接 GitHub，并掌握最常用的 Git 操作。

第一步：安装 Git（已安装可跳过）

前往官网 https://git-scm.com/downloads 下载并安装对应系统的 Git。安装完成后，在终端（Windows 用 Git Bash，macOS/Linux 用 Terminal）输入：bash

git --version

看到版本号说明安装成功。

第二步：配置 Git 全局用户信息

第一次使用 Git 需要告诉它“你是谁”。运行以下命令，替换为自己的信息：bash

git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

这会把用户名和邮箱写入全局配置文件（~/.gitconfig）。后续所有提交都会带上这个信息。查看配置是否成功：bash

git config --global --list

第三步：生成 SSH 密钥，安全连接

GitHub推荐使用 SSH 方式连接 GitHub，无需每次输入用户名密码。

  1. 生成密钥：

bash

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

注：如果系统不支持 ed25519，可用 ssh-keygen -t rsa -b 4096 -C "your.email@example.com" 按回车一路默认即可（不需要设置 passphrase 也可以）。密钥默认保存在 ~/.ssh/id_ed25519.pub（或 id_rsa.pub）。

  1. 查看公钥内容：

bash

cat ~/.ssh/id_ed25519.pub

复制全部内容（以 ssh-ed25519 或 ssh-rsa 开头）。

  1. 添加到 GitHub：

登录 GitHub → 右上角头像 → Settings → SSH and GPG keys → New SSH key → 标题随意 → 把复制的公钥粘贴到 Key 字段 → Add SSH key。

  1. 测试连接：

bash

ssh -T git@github.com

看到 Hi username! You've successfully authenticated... 就说明成功了。

第四步：创建本地仓库并推送到 GitHub

情况一：全新项目，从本地推到 GitHub

  1. 在 GitHub 上新建一个仓库（New repository），仓库名随意，不要勾选 Initialize this repository with a README。
  2. 在本地项目文件夹中初始化 Git 仓库：

bash

git init
  1. 添加远程仓库（origin 是远程仓库的默认别名）：

bash

git remote add origin git@github.com:你的用户名/仓库名.git
  1. 添加文件、提交、推送：

bash

git add .                    # 添加所有文件
git commit -m "Initial commit"   # 第一次提交
git branch -M main           # 强制将默认分支重命名为 main（GitHub 默认分支现在是 main）
git push -u origin main      # 推送并关联上游分支

以后日常操作就简单了：bash

git add .
git commit -m "更新说明"
git push                    # 因为已经设置了 -u，后续直接 push 即可

情况二：已有 GitHub 仓库，克隆到本地bash

git clone git@github.com:用户名/仓库名.git
cd 仓库名
# 修改代码后
git add .
git commit -m "更新说明"
git push

第五步：常用 Git 命令详解

命令
说明
git init
在当前目录初始化一个新的 Git 仓库
git add .
将所有改动文件加入暂存区
git commit -m "消息"
将暂存区内容提交到本地仓库
git status
查看当前仓库状态（有哪些文件改动、待提交等）
git log
查看提交历史
git pull
从远程仓库拉取最新代码（相当于 fetch + merge）
git push
将本地提交推送到远程仓库
git push -u origin main
第一次推送时建立本地 main 分支与远程 origin/main 的关联，后续可直接 git push

main vs origin 的区别（重点澄清）

  • main：是分支名（branch）。本地默认分支现在通常叫 main（以前叫 master），远程 GitHub 仓库的默认分支也是 main。
  • origin：是远程仓库的别名（remote）。当你执行 git remote add origin ... 时，就给远程 GitHub 仓库起了个简称叫 origin。你可以有多个远程仓库，比如 origin、upstream 等。

所以完整的第一次推送命令是：bash

git push -u origin main

含义：把本地的 main 分支推送到名为 origin 的远程仓库，并建立跟踪关系（upstream）。之后就可以直接用 git push 和 git pull 了。

最后：日常工作流建议

  1. 修改代码
  2. git status 查看改动
  3. git add .
  4. git commit -m "清晰的提交信息"
  5. git pull 先拉取最新代码（避免冲突）
  6. git push 推送

养成频繁提交、写清晰提交信息的习惯，你的代码历史会非常干净易读。到这里，你已经完全掌握了本地 Git 连接 GitHub 并进行日常操作的全部流程。

分享