Wiki / 软件工具 / git / git-quickstart

git-quickstart

Updated: 2026-04-19

Git Quick Start

从零开始，用最短路径打通 私有仓库 的远程管理全流程。

本篇不讲原理，只给操作步骤。想深入了解请阅读 Git 核心原理 和 Git 使用教程。

第一步：安装 Git

Windows

下载 Git 安装包，双击安装，所有选项保持默认即可。

macOS

brew install git

Linux

sudo apt update && sudo apt install git    # Ubuntu/Debian
sudo dnf install git                       # Fedora

验证

git --version
# 看到版本号即成功

第二步：配置身份

git config --global user.name "你的GitHub用户名"
git config --global user.email "你的GitHub注册邮箱"

# Windows 用户建议额外设置
git config --global core.autocrlf true
git config --global core.quotepath false

第三步：生成 SSH 密钥

ssh-keygen -t ed25519 -C "你的邮箱"
# 连按三次回车（使用默认路径，不设密码）

查看并复制公钥：

cat ~/.ssh/id_ed25519.pub

第四步：添加公钥到 GitHub

  1. 登录 github.com → 右上角头像 → Settings
  2. 左侧 SSH and GPG keys → New SSH key
  3. Title 随便填（如 我的电脑），把上一步复制的公钥粘贴到 Key 栏
  4. 点击 Add SSH key

测试连接

ssh -T git@github.com
# 首次连接输入 yes
# 看到 "Hi 用户名! You've been authenticated..." 即成功

如果超时，编辑 ~/.ssh/config（没有就新建），添加：

Host github.com
    HostName ssh.github.com
    Port 443
    User git

第五步：创建私有远程仓库

  1. GitHub 页面右上角 + → New repository
  2. 填写 Repository name（如 my-project）
  3. 选择 Private
  4. 不要勾选 Initialize（不添加 README、.gitignore 等）
  5. 点击 Create repository

第六步：本地项目推送到远程

# 进入你的项目目录（或创建新目录）
mkdir my-project && cd my-project

# 初始化 Git
git init

# 创建文件
echo "# My Project" > README.md

# 首次提交
git add .
git commit -m "初始提交"

# 关联远程仓库（替换为你的用户名和仓库名）
git remote add origin git@github.com:你的用户名/my-project.git

# 推送
git push -u origin main

如果报错 error: src refspec main does not match any，说明默认分支名是 master，执行：

git branch -M main
git push -u origin main

到这里，私有仓库远程管理流程已打通。 🎉

日常工作流

# ─── 每天开始 ───
git pull                          # 拉最新代码

# ─── 编写代码 ───
# ...编辑文件...

# ─── 提交 ───
git add .                         # 暂存改动
git commit -m "简短描述你做了什么"   # 提交
git push                          # 推送到远程

使用分支开发（推荐）

git switch -c feature-xxx         # 创建功能分支
# ...开发、git add、git commit...
git switch main                   # 切回主分支
git merge feature-xxx             # 合并
git push                          # 推送
git branch -d feature-xxx         # 清理分支

在另一台电脑上继续工作

  1. 在新电脑上重复第一步~第四步（安装 + 配置 + SSH）
  2. 记得把新电脑的公钥也添加到 GitHub
  3. 克隆仓库：
git clone git@github.com:你的用户名/my-project.git
cd my-project
# 然后就可以正常 pull/push 了

常用命令速查表

配置

命令 说明
git config --global user.name "名字" 设置用户名
git config --global user.email "邮箱" 设置邮箱
git config --list 查看所有配置

仓库

命令 说明
git init 初始化仓库
git clone <url> 克隆远程仓库
git remote add origin <url> 添加远程仓库
git remote -v 查看远程仓库

日常操作

命令 说明
git status 查看状态
git add . 暂存所有改动
git commit -m "说明" 提交
git push 推送到远程
git pull 拉取远程更新
git fetch 获取远程信息（不合并）

分支

命令 说明
git branch 查看分支
git switch -c <名称> 创建并切换分支
git switch <名称> 切换分支
git merge <名称> 合并分支
git branch -d <名称> 删除已合并分支

查看历史

命令 说明
git log --oneline 简洁历史
git log --oneline --graph --all 图形化历史
git diff 查看未暂存改动
git diff --staged 查看已暂存改动

撤销

命令 说明
git restore <文件> 撤销工作区修改
git restore --staged <文件> 取消暂存
git reset --soft HEAD~1 撤销最近一次 commit（保留改动）
git reset --hard HEAD~1 撤销最近一次 commit（丢弃改动）⚠️

SSH

命令 说明
ssh-keygen -t ed25519 -C "邮箱" 生成密钥对
ssh-add ~/.ssh/id_ed25519 添加密钥到 agent
ssh -T git@github.com 测试 SSH 连接
cat ~/.ssh/id_ed25519.pub 查看公钥

延伸阅读

文档 说明
Git 核心原理 理解 Git 的设计思想和内部机制
Git 安装与配置 详细的安装选项和配置说明
Git 使用教程 完整的操作指南和进阶用法

推荐外部资源

资源 说明
Pro Git（免费中文版） 最权威的 Git 书
Learn Git Branching 交互式可视化学习
GitHub Skills GitHub 官方教程
Git 飞行规则 出了问题怎么办

最后更新：2026-04-19

目录