2026Git 下载、安装、使用完整教程(附安装包)

Git 下载、安装、使用完整教程

    • [一、Git 简介(与SVN区别)](#一、Git 简介(与SVN区别))
    • [二、Git 下载](#二、Git 下载)
    • [三、Git 安装教程](#三、Git 安装教程)
      • [1. 安装(关键步骤已标注注意事项)](#1. 安装(关键步骤已标注注意事项))
      • [2. 验证安装是否成功](#2. 验证安装是否成功)
    • [四、Git 基础配置(安装后必须配置,否则无法正常提交代码)](#四、Git 基础配置(安装后必须配置,否则无法正常提交代码))
    • [五、Git 常用基础命令](#五、Git 常用基础命令)
      • [1. 初始化本地仓库](#1. 初始化本地仓库)
      • [2. 查看文件状态](#2. 查看文件状态)
      • [3. 添加文件到暂存区](#3. 添加文件到暂存区)
      • [4. 提交文件到本地仓库](#4. 提交文件到本地仓库)
      • [5. 查看提交记录](#5. 查看提交记录)
      • [6. 版本回退(恢复到之前的版本)](#6. 版本回退(恢复到之前的版本))
    • [六、Git 连接远程仓库(以 GitHub 为例)](#六、Git 连接远程仓库(以 GitHub 为例))
      • [1. 关联远程仓库](#1. 关联远程仓库)
      • [2. 推送代码到远程仓库(首次推送)](#2. 推送代码到远程仓库(首次推送))
      • [3. 拉取远程代码到本地(同步他人修改)](#3. 拉取远程代码到本地(同步他人修改))
      • [4. 克隆远程仓库到本地(首次获取远程项目)](#4. 克隆远程仓库到本地(首次获取远程项目))
    • 七、常见问题及解决方法(新手必看)
    • 八、新手注意事项总结

一、Git 简介(与SVN区别)

  • SVN是集中式版控制系统,必须联网才能工作,网络还要好
  • Git 是一款免费开源的分布式版本控制工具,没有中央服务器,不需要联网也可以工作,适合多人协作,常与 GitHub、Gitee、GitLab 等远程仓库搭配使用。分为 本地仓库、工作区、暂存区、远程仓库。

二、Git 下载

三、Git 安装教程

1. 安装(关键步骤已标注注意事项)

  1. 打开安装包后,首先弹出许可协议,点击「Next」(无需修改,直接同意即可)。

  2. 选择安装路径:默认路径在C盘,建议修改为非C盘(如 D:\Git),修改后点击「Next」(注意:路径需为纯英文,禁止含中文、空格、特殊字符)。

  3. 组件选择:保持默认勾选(无需新增或删除组件),点击「Next」(默认组件已满足日常使用需求)。

  4. 开始菜单文件夹:保持默认名称「Git」,点击「Next」,方便后续在开始菜单查找Git程序。

  5. 默认编辑器选择:保持默认「Vim」,点击「Next」(无需修改,后续可根据需求更换编辑器)。

  6. 这个选项是设置 git init 时默认分支的名字

  • 扩展:master 这个词源自 master/slave(主 / 从) 的技术术语,带有奴隶制、种族歧视的历史联想。在 2020 年 Black Lives Matter 运动后,全球科技社区开始推动移除这类敏感词汇:GitHub、GitLab、Bitbucket 等平台率先把默认分支从 master 改为 main;Git 官方也跟进,允许用户自定义默认分支名,建议选择main;以后想改也很简单
    不管现在选了什么,之后都可以用命令修改:
b 复制代码
# 全局设置默认分支为 main
git config --global init.defaultBranch main
  1. 环境变量选择:选择第三个选项(「Use Git and optional Unix tools from the Command Prompt」),点击「Next」(推荐选项,可在cmd中直接使用Git命令)。

  2. 选择 HTTPS 传输后端

  • 强烈建议手动选择第一个选项'Use the OpenSSL library'。虽然第二个选项是 Windows 默认推荐,但 OpenSSL 能提供更好的跨平台兼容性,避免后续在 Linux 服务器拉取代码时出现证书验证失败等问题,尤其适合多系统协作的开发场景。"后续可修改:
cmd 复制代码
# 切换到 Windows Secure Channel(推荐企业环境)
git config --global http.sslBackend schannel

# 切换到 OpenSSL(跨平台/旧习惯)
git config --global http.sslBackend openssl


  1. 换行符格式:保持默认设置,点击「Next」(避免跨系统协作时出现换行符异常)。


  1. 终端模拟器选择:保持默认「MinTTY」,点击「Next」(兼容性更好,操作更便捷)。


  1. 剩余选项(如Git Credential Manager、Enable file system caching)全部保持默认,点击「Install」开始安装。



  1. 安装完成后,取消勾选「View Release Notes」,点击「Finish」即可。
  • Launch Git Bash
    含义:安装完成后,自动打开 Git Bash 终端窗口。
    作用:Git Bash 是 Git 自带的类 Unix 命令行环境,你可以在这里执行 git 命令(如 git clone、git push),也能使用 Linux 风格的命令(如 ls、cd)。
  • View Release Notes
    含义:安装完成后,自动在浏览器中打开 Git 本次版本的更新日志(Release Notes)

2. 验证安装是否成功

  1. 按下Win + R,输入 cmd 打开命令行窗口(或右键桌面,选择「Git Bash Here」)。

  2. 在命令行中输入以下命令,回车执行:
    git --version

  3. 若出现版本号(如git version 2.53.0.windows.2),说明安装成功;若提示「git 不是内部或外部命令」,则需重新安装,检查环境变量配置。

四、Git 基础配置(安装后必须配置,否则无法正常提交代码)

配置核心:设置用户名和邮箱,需与 GitHub、Gitee 等远程仓库绑定的用户名、邮箱保持一致,否则无法正常推送代码到远程仓库。

  1. 打开 cmd 或 Git Bash(右键桌面选择「Git Bash Here」)。

  2. 输入以下两条命令,分别配置用户名和邮箱(将引号内内容替换为自己的信息):

cmd 复制代码
# 配置用户名(GitHub/Gitee 用户名,无需加引号)
git config --global user.name 你的用户名

# 配置邮箱(GitHub/Gitee 绑定的邮箱,无需加引号)
git config --global user.email 你的邮箱
  1. 验证配置是否生效:输入以下命令,回车后若能看到配置的用户名和邮箱,说明配置成功: git config --list
  • 注意事项:--global 参数表示全局配置,配置一次后,所有本地Git仓库都会生效,无需重复配置。

五、Git 常用基础命令

  • 所有命令均在 Git Bash 或 cmd 中执行,注意命令拼写正确,区分大小写(Git命令不区分大小写,但文件名、路径区分)。

1. 初始化本地仓库

bash 复制代码
git init

作用:将当前文件夹变成 Git 可管理的仓库,执行后会在文件夹中生成一个隐藏的 .git 文件夹(不要删除,否则仓库会失效)。

注意:每个项目文件夹只需初始化一次,无需重复执行。

2. 查看文件状态

bash 复制代码
git status

作用:查看当前仓库中哪些文件被修改、哪些文件未添加到暂存区、哪些文件未提交到本地仓库,是日常开发中最常用的命令之一。

提示说明:红色文件表示未添加到暂存区,绿色文件表示已添加到暂存区。

3. 添加文件到暂存区

bash 复制代码
# 添加单个文件(将「文件名」替换为实际文件名,如 test.txt)
git add 文件名

# 添加当前文件夹下所有修改、新增的文件(推荐,无需逐个添加)
git add .

注意:添加后需执行提交命令,文件才会真正保存到本地仓库。

4. 提交文件到本地仓库

bash 复制代码
git commit -m "本次修改的说明文字"

注意事项:

  • -m 后面的说明文字必须填写,且要简洁明了(如「新增登录功能代码」「修复首页布局bug」),方便后续查看提交记录。

  • 提交前必须先执行 git add 将文件添加到暂存区,否则提交会失败。

5. 查看提交记录

bash 复制代码
git log

作用:查看所有提交记录,包括提交人、提交时间、提交说明、版本号(版本号用于版本回退)。

注意:按 q 键可退出提交记录查看界面。

6. 版本回退(恢复到之前的版本)

bash 复制代码
git reset --hard 版本号

注意事项:

  • 版本号可通过 git log 查看,只需复制前7-8位即可(无需复制完整版本号)。

  • 版本回退不可逆,回退前建议确认是否需要保留当前修改,避免误操作导致代码丢失。

六、Git 连接远程仓库(以 GitHub 为例)

  • 前提:已注册 GitHub 账号,且已在本地配置好 Git 用户名和邮箱(与 GitHub 账号一致)。

1. 关联远程仓库

bash 复制代码
git remote add origin 远程仓库地址

说明:

  • 「远程仓库地址」可在 GitHub 仓库页面点击「Code」,复制 HTTPS 或 SSH 地址(新手推荐使用 HTTPS 地址,无需配置密钥)。

  • 「origin」是远程仓库的别名,可自定义(如「github」),但建议使用默认别名,方便记忆和后续操作。

  • 注意:每个本地仓库只需关联一次远程仓库,重复关联会报错。

2. 推送代码到远程仓库(首次推送)

bash 复制代码
git push -u origin main

注意事项:

  • 首次推送需添加 -u 参数,用于绑定本地分支和远程分支,后续推送可直接使用 git push

  • 推送时会弹出 GitHub 登录窗口,输入 GitHub 用户名和密码(或令牌),验证通过后即可推送。

  • 若推送失败,先执行 git pull origin main 拉取远程仓库最新代码,解决冲突后再推送。

3. 拉取远程代码到本地(同步他人修改)

bash 复制代码
git pull origin main

作用:将远程仓库最新的代码同步到本地,避免本地代码与远程代码不一致,导致推送失败。

注意:多人协作时,每次提交代码前,建议先执行 git pull 拉取最新代码。

4. 克隆远程仓库到本地(首次获取远程项目)

bash 复制代码
git clone 远程仓库地址

作用:将远程仓库的所有代码、提交记录一次性下载到本地,无需手动初始化仓库和关联远程仓库(克隆后自动关联)。

注意:克隆时会在当前文件夹下生成一个与远程仓库同名的文件夹,无需提前创建文件夹。

七、常见问题及解决方法(新手必看)

  1. 问题1:cmd 中输入 git 命令,提示「git 不是内部或外部命令」

    解决方法:重新安装 Git,安装时确保选择第三个环境变量选项;若已安装,可手动配置环境变量(将 Git 安装路径下的 bin 文件夹路径添加到系统环境变量 PATH 中)。

  2. 问题2:推送代码(git push)失败,提示冲突

    解决方法:先执行git pull origin main 拉取远程最新代码,打开冲突文件(带有 <<<<<<< HEAD=======>>>>>>> origin/main 标记),修改冲突内容,保存后执行 git add .git commit -m "解决冲突",再执行 git push

  3. 问题3:提交记录错误,想删除最近一次提交

    解决方法:执行 git reset --hard HEAD^(HEAD^ 表示上一个版本),注意此操作不可逆,需确认无重要修改。

  4. 问题4:连接 GitHub 失败,提示连接超时

    解决方法:检查网络连接是否正常;确认远程仓库地址是否正确;关闭本地杀毒软件、防火墙重试;若使用 SSH 地址,需配置 SSH 密钥。

  5. 问题5:忘记 Git 配置的用户名和邮箱

    解决方法:执行 git config --list,即可查看当前配置的用户名和邮箱。

八、新手注意事项总结

  • Git 安装全程默认 Next 即可,重点注意安装路径(纯英文)和环境变量选择。

  • 安装后必须配置用户名和邮箱,且与远程仓库(GitHub/Gitee)一致,否则无法推送代码。

  • 核心操作流程:初始化仓库(git init)→ 添加文件(git add .)→ 提交(git commit -m "说明")→ 推送(git push)。

  • 多人协作时,先拉取(git pull)再推送(git push),避免冲突。

  • 版本回退不可逆,操作前务必确认是否需要保留当前修改。

  • 若遇到命令报错,先检查命令拼写是否正确,再对照常见问题排查。

相关推荐
AI自动化工坊9 小时前
ProofShot实战:给AI编码助手添加可视化验证,提升前端开发效率3倍
人工智能·ai·开源·github
Moshow郑锴9 小时前
Git如何上传目录到github项目进行初始化
git
疯狂成瘾者10 小时前
上传到 GitHub 的步骤总结
大数据·elasticsearch·github
第一程序员14 小时前
Python基础学习路径:非科班转码者的入门指南
python·github
badhope16 小时前
概率论如何让机器学习不再玄学
人工智能·深度学习·机器学习·数据挖掘·github
evan202016 小时前
faster-whisper 音频转字幕 懒人整合包
github
IT WorryFree17 小时前
如何设置微信群机器人
微信·github
Risehuxyc18 小时前
github里README和*.md的编写规则
github
badhope18 小时前
10个高星GitHub项目推荐
python·深度学习·计算机视觉·数据挖掘·github