微信优化

weixinyouhua

git安装配置步骤是什么?git安装配置教程详解

2026-09-17 05:09:36

Git安装与配置的核心答案:把官方安装包下载到本地、一路下一步完成安装、用git –version验证环境,最后配置用户名和邮箱,整个过程不到10分钟。

git安装前需要准备什么

确认操作系统与版本选择

Windows、macOS、Linux的安装包各不相同,国内多数开发者使用Windows环境,建议直接去Git官网下载对应系统版本,官网有时加载较慢,可以通过国内镜像站下载,速度会快不少。

操作系统 安装包类型 需要注意的点
Windows 10/11 .exe文件 选择64位版本(x64)
macOS .dmg文件 区分Intel芯片与Apple Silicon芯片
Ubuntu/Debian apt命令安装 需要sudo权限

Windows用户经常能看到两个版本选择,Portable版适合U盘随身携带使用,标准版直接装进系统,选标准版就够日常开发用了。

检查电脑是否已经安装过git

打开命令行工具,输入git –version,如果返回类似git version 2.39.2的信息,说明电脑已安装,返回command not found或git不是内部或外部命令,就需要从零开始装。

这一步很多人会跳过,装到一半才发现环境变量冲突,反而更浪费时间。

Windows系统git安装完整步骤

借助安装向导完成基础安装

下载好的exe文件双击运行,安装向导会依次弹出几个设置页面,比较关键的是选择安装路径这一步,默认安装在C:\Program Files\Git是没问题的,想改到D盘也完全可以,路径中不要出现中文即可。

后面的组件选择默认配置就行,不需要逐项修改,比较推荐保留“Git Bash Here”和“Git GUI Here”这两个右键菜单选项,后边操作方便很多。

安装向导走完点击Finish,git基础环境就已经装好了。

git配置环境变量的具体操作

安装向导默认会帮忙配置好环境变量,部分情况下环境变量没有自动写入,就需要手动补一遍。

在电脑左下角搜索框输入“环境变量”,打开“编辑系统环境变量”,点击“环境变量”按钮,在系统变量里找到Path,点击编辑,把C:\Program Files\Git\cmd这一行加进去,然后一路点击确定保存。

检查是否配置成功,重新打开一个命令行窗口,输入git –version,能够正确输出版本信息,说明git配置环境变量的操作已经生效,国内不少教程把这一步写得特别复杂,其实就是把cmd目录加进Path而已。

git安装配置步骤是什么?git安装配置教程详解

Windows安装完git后的首次配置

打开命令行或者Git Bash,执行以下操作:

git config --global user.name "你的名字拼音缩写"
git config --global user.email "你常用的邮箱地址"
git config --global user.name "zhangsan"
git config --global user.email "zhangsan@example.com"

这两条命令设置了提交代码时显示的作者信息,配置完之后可以用git config –list确认一下设置是否正确,行业共识认为,这一步是git安装与配置里最容易遗漏的地方,不配置的话后续提交代码会报错或者无法关联到你的账户。

macOS和Linux环境下git安装方式

macOS使用Homebrew一键安装

已经安装过Homebrew的Mac用户,直接执行:

brew install git

没有Homebrew的,可以下载dmg安装包安装,或者使用Xcode Command Line Tools自带git,macOS用户安装完成后不需要手动配置环境变量,系统会自动识别安装路径。

Linux系统用包管理器直接安装

Ubuntu和Debian系执行:

sudo apt-get update
sudo apt-get install git

CentOS和Fedora执行:

sudo yum install git

Linux系统同样不需要手动配置环境变量,包管理器会处理这些细节,安装完成后用git –version验证一下即可。

git配置文件优先级与查找方式

系统级、全局级、仓库级配置三层结构

git的配置信息存放在三个位置,优先级从低到高分别是系统级、全局级、仓库级,系统级配置在git安装目录下的etc/gitconfig文件,全局配置在用户主目录下的.gitconfig,仓库配置在项目根目录下的.git/config。

实际操作中碰到配置不生效的场景,基本就是全局配置和仓库配置冲突了,在某个仓库内用git config –list能够看到当前仓库生效的全部配置项,不带任何位置参数查看的是最终合并后的结果。

修改已有配置的方式

想修改之前设置的用户名:

git config --global user.name "newname"

想在某个特定仓库使用不同的邮箱:

git config user.email "another@example.com"

去掉–global参数就代表只对当前仓库生效,不会影响其他项目。

常见git安装失败场景与应对方案

git安装配置步骤是什么?git安装配置教程详解

环境变量没生效

安装完输入git –version提示找不到命令,多数情况下是Path变量没有正确写入或者命令行没有重启,新开一个终端窗口试试,依然不行就按前文方式手动配置环境变量。

安装包下载慢或下载失败

Git官网比较慢是常态,尤其是高峰期,国内开发者可以改用淘宝镜像或华为云镜像下载,速度快不少,下载完成后先校验一下文件大小,跟官网标注一致再执行安装。

SSL报错导致clone失败

安装好git之后克隆GitHub仓库经常遇到SSL证书验证失败,这是系统缺少根证书比较常见,可以执行:

git config --global http.sslverify false

临时绕过证书验证,不推荐长期关闭验证,但短期内解决clone问题很实用。

github clone速度慢有哪些解决办法

国内网络环境下clone GitHub仓库速度确实一般,改用国内代码托管平台的镜像仓库是最直接的方案,或者给git配置代理服务,配置代理的方式是:

git config --global http.proxy http://127.0.0.1:7890
git config --global https.proxy http://127.0.0.1:7890

端口号需要和自己本地代理软件保持一致,使用完毕可以执行git config –global –unset http.proxy清除配置。

配置ssh密钥打通远程仓库

生成密钥对的操作

打开Git Bash,执行:

ssh-keygen -t rsa -b 4096 -C "你的邮箱"

一路回车接受默认路径即可,密钥生成后,在用户主目录下找到.ssh文件夹,里面有id_rsa和id_rsa.pub两个文件。id_rsa是你的私钥,绝对不能泄露,id_rsa.pub可以放心提交到代码托管平台。

把公钥配置到代码托管平台

登录GitHub、Gitee或GitLab,进入Settings->SSH and GPG keys,把id_rsa.pub里的内容全部复制粘贴进去保存,验证是否配置成功:

ssh -T git@github.com

返回成功提示就说明公钥已经生效,此后使用SSH协议克隆和推送代码,都不需要重复输入账号密码,体验比HTTPS协议舒服很多。

SSH相比HTTPS的优势

克隆远程仓库时看到两种地址形式,HTTPS地址在推代码时需要验证身份,SSH地址配置好密钥后完全免密操作,对于每天频繁推送代码的开发者,SSH是首选协议,对偶尔用一下的开发者,HTTPS也可以接受。

git安装好后推荐检查的环境状态

git安装配置步骤是什么?git安装配置教程详解

用git –version确认安装的版本号,再用git config –list确认用户信息已经正确配置,最后用git init在任意目录初始化一个测试仓库,执行git status看是否正常输出目录状态。

还可以顺手配置几个常用的快捷命令:

git config --global alias.st status
git config --global alias.co checkout
git config --global alias.br branch
git config --global alias.cm commit

配置完成后在任意git仓库输入git st就能代替git status,后续操作能提升不少效率,据官方文档说明,alias配置是git高度可定制化的重要体现之一。

git版本升级有没有必要

Git保持了每两个月左右发布一个新版本的节奏,新版本主要修复已知漏洞、优化性能、增加新协议支持,长期停留在旧版本,代码托管平台的某些新特性可能无法使用。

升级方式其实很简单,Windows直接运行旧版安装包,向导会提示覆盖升级,macOS执行brew upgrade git,Linux执行sudo apt-get update && sudo apt-get upgrade git即可。

如果你已经按照以上步骤完成了安装、配置环境变量、设置了用户名和邮箱,也验证过SSH连接,那么你的git环境已经完全准备好了,可以放心开始管理代码和版本。

git安装配置相关问题解答

git安装教程最推荐观看哪类资料

图文教程比视频更适合查阅,安装配置过程中经常需要来回切换窗口操作,文字步骤可以随时对照,优先看官方文档,其次是主流技术博客上的图文实操记录,注意区分文章对应的操作系统,Windows和macOS的安装方式差异很大。

为什么git配置了用户名和邮箱代码还是没法提交

先查看当前仓库是否覆盖了全局配置,在项目目录执行git config user.name和git config user.email,没有返回值说明仓库级配置为空,需要补充设置,部分情况下还需要检查是否进入了正确的仓库目录,在非git仓库目录执行提交命令同样会报错,最后检查远程仓库地址是否有访问权限,用git remote -v查看关联的远程地址格式是否正确,SSH协议地址和HTTPS协议地址不能混用。

重新安装git之前的旧配置会不会被覆盖

默认情况下,重新安装git不会删除用户主目录下的全局配置文件,之前设置过的用户名、邮箱、别名、代理信息都会保留,如果系统重装导致配置文件丢失,只需要重新执行git config –global命令把基本信息补回来,其他高级选项按需重新配置即可。

相关文章

2024年,SaaS软件行业碰到获客难、增长慢等问题吗?

我们努力让每一次邂逅总能超越期待