> 技术文档 > Git详细使用教程-小白版_git操作

Git详细使用教程-小白版_git操作


Git详细使用教程

一、安装Git

1.1 Windows系统安装

  1. 访问 Git 官网 下载安装包。
  2. 运行安装程序,推荐选择默认配置(建议勾选 “Use Git from Windows Command Prompt”)。
  3. 安装完成后,通过命令 git --version 验证安装是否成功。

1.2 macOS/Linux 系统安装

# macOS (Homebrew)brew install git# Ubuntusudo apt-get install git

Git 基本操作

二、配置Git

2.1配置用户信息

安装好git后,首次使用时需要设置用户名和邮箱,在命令行或终端中使用下面的命令可以设置git自己的名字和电子邮件。这是因为Git是分布式版本控制系统,所以,每个机器都必须自报家门:你的名字和Email地址。

# 全局配置(适用于所有仓库git config --global user.name \"Your Name\"git config --global user.email \"your.email@example.com\"# 单仓库配置(当前目录生效)git config user.name \"Your Name\"git config user.email \"your.email@example.com\"

注意git config命令的–global参数,用了这个参数,表示你这台机器上所有的Git仓库都会使用这个配置,当然也可以对某个仓库指定不同的用户名和Email地址。

验证配置:

git config --list #查看配置

三、创建仓库

3.1初始化新仓库

在项目文件夹中执行以下命令初始化一个新的Git仓库:

git init

作用:初始化一个新的 Git 仓库。

  • 在当前目录下创建一个 .git 文件夹,用于存储版本控制元数据(提交历史、分支、标签等)。
  • 适用于本地新建项目。

3.2克隆远程仓库

从远程仓库克隆代码到本地:

#git clone 远程仓库地址git clone https://github.com/ultralytics/ultralytics.git

参数说明:

  • depth 1:克隆仅最新提交(轻量级克隆)。
  • branch :指定分支克隆。

四、基础操作

4.1 查看仓库状态

git status

输出示例:

On branch mainChanges not staged for commit: (use \"git add ...\" to update what will be committed) modified: README.md

4.2 添加文件至暂存区

三种方式:

# 1.添加单个文件git add README.md# 2.添加所有修改(包括新文件和删除)git add .# 3.添加指定文件类型(如所有 .py 文件)git add *.py

4.3 提交更改

提交暂存区中的文件到本地仓库,并附上提交信息:git commit -m \"提交说明\"

git commit -m \"Initial commit\"

作用:将暂存区中的更改提交到本地仓库,并附带提交信息 \"Initial commit\"

  • 每次提交都会生成一个唯一的提交 ID(SHA-1 哈希值),记录此次更改的内容和作者信息。
  • 提交信息 \"Initial commit\" 是对本次提交的简要描述,通常用来说明这次提交的目的或内容。

最佳实践:

  • 提交信息以动词开头(如 fix、add、update)。
  • 长信息可换行:
git commit -m \"Fix login bug解决用户登录时的验证码验证问题\"

4.4 查看所有提交的日志记录

git log

Git详细使用教程-小白版_git操作
常用参数:

  • oneline:简洁显示(每行一个提交)。
  • graph:显示分支合并图形。
  • author=“name”:按作者筛选提交。

4.5 回退版本

4.5.1 撤销提交(保留当前更改)
# 回退到指定提交(推荐用于公开分支)git revert <commit-hash>

例如:git revert F4114b031915bafdb94d95f310ce6f4ccca259bd #就会回滚到这个的上一个版本

4.5.2 直接重置(本地未提交时使用)
# 强制回到指定提交(丢失后续更改!)git reset --hard <commit-hash>

4.6 查看差异

# 查看工作区与暂存区差异git diff# 查看暂存区与最新提交差异git diff --cached# 查看两个提交之间的差异git diff <commit1> <commit2>

五、分支管理

Git详细使用教程-小白版_git操作

5.1 查看分支

git branch # 仅显示本地分支git branch -a # 包含远程分支

5.2 重命名当前分支为 main

git branch -M main

作用:重命名当前分支为 main

  • 默认情况下,Git 初始化时会创建一个名为 master 的分支(取决于配置)。如果你希望使用 main 作为默认分支名称,可以运行此命令。
  • -M--move --force 的缩写,表示强制移动或重命名分支。

5.3 创建与切换分支

git checkout -b new-feature # 创建并切换到新分支

5.4 合并分支

# 合并分支到当前分支git merge new-feature# 解决冲突后继续合并git add conflicting-filegit merge --continue

5.5 删除分支

git branch -d merged-branch # 删除已合并的分支git branch -D unmerged-branch # 强制删除未合并分支

六、远程仓库操作

6.1 关联远程仓库

git remote add origin https://github.com/your-repo.gitgit remote -v # 查看远程仓库信息

作用:将远程仓库地址添加到本地仓库,并命名为 origin

  • 远程仓库是指托管代码的服务器(如 GitHub、GitLab 等)。
  • origin 是远程仓库的默认名称,你可以通过它与远程仓库进行交互。
  • https://github.com/your-repo.git 是远程仓库的 URL 地址。

6.2 推送与拉取

# 推送本地分支到远程git push origin main# 拉取远程更新(自动合并)git pull origin main# 强制推送(慎用!)git push -f origin main

6.3 远程仓库管理

# 删除远程分支git push origin --delete feature-branch
git push -u origin main

作用:将本地 main 分支的代码推送到远程仓库的 main 分支,并设置默认上游分支。

  • 推送(Push)是将本地提交同步到远程仓库的操作。
  • -u--set-upstream 的缩写,表示将本地分支与远程分支关联起来。关联后,以后可以直接使用 git pushgit pull,而无需指定远程仓库和分支。
  • origin 是远程仓库的名称,main 是远程分支的名称。
    主分支main

创建分支(例如:创建CGY分支)。
合并分支(合并前需切换到主分支)使用命令 git merge (例如:git merge CGY),这时候会将两个分支合并。

6.4 删除分支:

  • 删除本地分支(合并后的分支):git branch -d
  • 强制删除未合并的分支:git branch -D
  • 删除远程分支:git push origin --delete
  • 强制删除未合并的分支:git branch -D
  • 删除远程分支:git push origin --delete

七、高级功能

7.1 保存工作现场(Stash)

# 暂存当前更改git stash# 恢复暂存的更改git stash apply# 清除暂存git stash drop

7.2 交互式变基(Rebase)

# 重新整理提交历史git rebase -i HEAD~3

7.3 标签管理

# 创建标签git tag v1.0.0# 推送标签到远程git push origin --tags