超实用Git基础命令大全快速入门指南

Git 作为分布式版本控制系统，是开发者日常协作、代码管理的必备工具。本文整理了最核心的 Git 基础命令，从环境配置到远程仓库同步，从版本回退到文件操作，搞定新手入门所需的全部知识点，命令清晰可直接复用。

常用命令

Git 核心工作流：【配置 → 本地操作 → 远程同步 → 版本管理】，本文覆盖了新手入门的所有高频命令

1.初始配置命令

Git 安装完成后，首先需要配置用户身份信息(邮箱与用户名)，这会关联到你的每一次代码提交，方便追溯提交者信息。

• 配置用户邮箱（替换为你的注册邮箱，与远程仓库/github/gitlab保持一致）

  git config --global user.email "your_email@xxx.com"
  

• 配置用户名（替换为你的自定义用户名，远程仓库会显示该名称）

  git config --global user.name "your_username"
  

global 表示全局配置，所有本地仓库都会沿用该配置，若需为单个仓库单独配置，可进入该仓库目录后去掉该参数。

• 验证配置是否成功：

  git config --list
  

2.状态与信息查询命令

日常开发中，需要频繁查询文件修改状态、分支信息等，以下命令是必备工具。

# 查看当前仓库的文件状态（核心命令）
# 会提示哪些文件已修改、哪些文件未被追踪、哪些文件已加入暂存区
git status
# 查看文件的具体修改内容（对比工作区与暂存区的差异）
# 若需查看指定文件修改：git diff xxx.file
git diff

# 查看当前本地仓库已存在的所有分支
git branch
# 查看远程仓库分支信息
git branch -r

# 查看本地+远程所有分支信息
git branch -a

3. 本地仓库操作命令

本地仓库的核心工作流程为：【创建仓库 → 新增/修改文件 → 提交更改】，三步完成本地代码版本管理。

1. 创建本地仓库

# 进入目标项目目录
# 初始化本地 Git 仓库，会在当前目录生成隐藏的 .git 文件夹, 它是仓库核心配置文件
git init .

2. 将文件添加到本地仓库暂存区

暂存区是 Git 工作流程中的中间环节，用于临时存放待提交的修改。

git add .
# 添加指定单个文件到暂存区：git add xxx.file
# 添加指定多个文件到暂存区：git add file1.file file2.file
# 撤销暂存区的指定文件：git reset HEAD xxx.file

3. 提交暂存区更改到本地仓库

提交后会在本地仓库生成一条完整的版本记录，包含提交信息、提交者、提交时间等。

# 将暂存区的所有更改提交到本地仓库，并添加提交说明(-m 后为提交信息)
git commit -m "your commit info"

4.远程仓库操作命令

本地仓库仅能满足个人开发，团队协作或代码备份需要关联远程仓库(GitHub/Gitee/自建 Git 服务器)，以下是核心操作命令。

1.配置 SSH Key

远程仓库连接支持 SSH 和 HTTPS 两种方式，SSH 方式配置完成后可实现免密提交，无需每次输入账号密码，是首选方式。

1. 步骤1：检查并生成 SSH Key

# 先检查本地是否已存在 SSH Key（进入家目录的 .ssh 文件夹查看）
# 推荐使用 ed25519 算法（安全性更高，GitHub 优先推荐），替换为你的注册邮箱
ssh-keygen -t ed25519 -C "your_email@xxx.com"

# 若部分旧平台不支持 ed25519，可使用 rsa 算法（兼容更好）
ssh-keygen -t rsa -C "your_email@xxx.com"

2. 步骤2：关键说明

• 执行命令后会提示设置存储路径和密码，直接回车即可
• id_rsa 是【私钥】，相当于你的身份凭证，切勿泄露给他人，也不要随意修改或删除。
• id_rsa.pub 是【公钥】，可公开分享，需要将其内容复制到远程仓库Web配置界面(Github/Gitlab/自建gitweb)的 SSH Key 配置中。

补充：如果自建局域服务器可以将 SSH Key 上传到自建服务器

# 替换为你的服务器用户名和服务器 IP 地址，实现免密登录服务器
sh-copy-id username@server_ip

2. 关联远程仓库

# 将地仓库与远程仓库建立关联，origin 是远程仓库的别名（可自定义，默认常用 origin）
# 替换为你的远程仓库 SSH 地址（从 GitHub/Gitee 仓库中复制）
git remote add origin git@xxx.com:your_username/your_repo.git

3. 切换/重命名分支

# 将当前分支重命名为 main 分支（适配 GitHub/Gitee 的默认分支规范，原默认分支多为 master）
git branch -M main

4. 推送到远程仓库

# 将本地 main 分支的代码推送到远程 origin 仓库，-u 表示建立本地分支与远程分支的关联（首次推送必加）
git push -u origin main

5. 强制推送到远程仓库

# 仅在确认远程仓库内容无用（如：版本回退后需同步远程）时使用，协作场景下禁止随意使用
git push -f -u origin main

6. 远程仓库同步到本地

# 拉取远程仓库的最新代码并合并到当前本地分支（日常协作必备，避免代码冲突）
git pull origin main

5. 版本回退命令

开发中若提交了错误代码，或需要回到历史版本，可使用 Git 的版本回退功能。

1. 查看版本历史记录

# 查看完整的 Git 提交日志（包含提交者、提交时间、提交哈希值、提交信息）
git log
# 简化日志输出，只显示提交哈希值（前7位）和提交信息（更清晰，推荐使用）
git log --pretty=oneline

2. 版本回退核心命令

Git 用 HEAD 表示当前版本，通过 ^ 或 ~ 表示历史版本。

# 退回到上一个版本（核心命令），--hard 表示彻底回退，工作区、暂存区、仓库均同步到目标版本
git reset --hard HEAD^

1. 版本标识说明

• HEAD：当前版本（最新提交的版本）。
• HEAD^：上一个版本。
• HEAD^^：上上一个版本。
• HEAD~100：往上 100 个版本（避免输入大量 ^，高效便捷）。
• 也可直接使用提交哈希值回退到指定版本（精准回退）：git reset –hard 1234567（1234567 为 git log 查看的提交哈希值前7位）。

6.撤销更改与文件删除命令（日常必备）

1. 撤销工作区文件的修改（未添加到暂存区）

# 撤销指定文件的工作区修改，恢复到暂存区的状态
# 注意：该命令会丢弃工作区的未提交修改，无法恢复，谨慎使用
git checkout -- xxx.file
# 补充：新版 Git 推荐使用更清晰的命令：git restore xxx.file

2. 删除文件相关操作

1. 方式1：仅删除本地工作目录文件

# 直接删除本地工作目录中的指定文件（与普通的文件删除操作一致，Git 会检测到该文件已删除）
rm xxx.file

2. 方式2：从版本库和本地工作目录中同时删除文件

# 1. 从 Git 版本库和本地工作目录中同时删除指定文件
git rm xxx.file
# 2. 提交该删除操作，生成版本记录（完成版本库的删除同步）
git commit -m "remove: 删除 xxx.file 文件"

3. 方式3：仅从版本库中删除文件（保留本地工作目录文件，常用）
   适用于误将不需要追踪的文件（如：日志文件、编译产物）提交到版本库，需要保留本地文件仅删除版本库中的记录。

# 1. 从 Git 版本库中删除指定文件/文件夹（--cached 表示仅操作暂存区/版本库，保留本地文件）
git rm --cached bin  # 文件夹无需加后缀，直接填写文件夹名称
# 2. 提交该删除操作，生成版本记录
git commit -m "remove: 从版本库中删除 bin 文件夹（保留本地）"