Git安装和配置是每个开发者入门的必修课,核心答案就是:下载对应系统的安装包、一路默认安装、然后配置用户名和邮箱、最后生成SSH密钥连接远程仓库,整个过程熟练后不到十分钟就能搞定。
Git安装其实很简单
很多人第一次接触Git会被各种术语吓到,其实安装阶段没什么技术含量,无论你是Windows用户还是macOS用户,本质就是获取安装包、双击运行、按提示操作,只有在配置环节才需要动点脑子,我们一步步拆开来看。
Windows系统下Git安装教程
Windows用户最常问的就是“git安装教程哪个版本靠谱”这类问题,其实官方渠道只有一个,去Git官网下载对应系统版本的安装包,选择64位即可,整个安装过程几乎不需要改动默认选项,唯一可能需要留意的是选择编辑器那一步,默认用Vim也可以,如果你不习惯Vim操作,建议在下拉列表里选VS Code或Notepad++。
安装完成后,在桌面空白处点击鼠标右键,如果看到Git Bash Here和Git GUI Here两个选项,说明安装成功了,Git Bash是一个模拟Linux命令行的终端工具,后面所有操作都建议在这个环境里执行。
macOS和Linux下的安装方式
macOS用户如果装了Homebrew,一条命令就能搞定:brew install git,没装Homebrew的话,去官网下载.dmg安装包同样方便,Linux用户更简单,基于Debian的发行版用sudo apt install git,基于Red Hat的用sudo yum install git,装完之后在终端输入git –version验证一下,能看到版本号说明一切正常。
Git配置是重中之重
很多人装完Git就急着用,结果提交代码时提示“Please tell me who you are”,这就是跳过了配置环节的下场,Git不像某些软件装完就能用,它需要知道你是谁,才能在你的每次提交上署名,这个配置过程叫git config,是整个Git使用体验的基础。
Git配置user.name和user.email
打开Git Bash,输入以下两行命令:

- git config –global user.name “你的名字”
- git config –global user.email “你的邮箱”
这里的名字和邮箱建议用GitHub或Gitee上注册的同一个,这样你的提交记录才能正确关联到你的账号,用–global参数意味着全局生效,以后这台机器上所有仓库都默认使用这个身份,不用每个项目重新配。
如果某个项目想用不同的身份提交,在项目目录下去掉–global参数重新设置即可,也可以用git config –list查看当前所有配置,检查是否设置成功。
换行符和编辑器等进阶配置
Windows用户强烈建议多做一步换行符配置,因为Windows和Linux系统默认换行符不同(Windows是CRLF,Linux是LF),如果不处理,你的代码可能在没有改动的情况下被标记为大量变更,行业共识认为,在Windows上执行git config –global core.autocrlf true是最稳妥的选择,提交时自动转为LF,检出时转为CRLF,这样跨平台协作不会出乱子。
编辑器配置也顺手做一下,执行git config –global core.editor “code –wait”可以把默认编辑器设为VS Code,以后写提交信息就不怕误入Vim出不来了。
SSH密钥和远程仓库连接
本地配置好之后,下一步是连接远程仓库,比如GitHub、Gitee或公司内部的GitLab,绝大多数场景下用HTTPS协议虽然也能用,但每次推送都要输账号密码,体验很差,更推荐的方式是配置SSH密钥,一劳永逸。
git配置ssh密钥如何操作
首先检查电脑上是否已有密钥,执行ls -al ~/.ssh,如果没有任何输出或提示目录不存在,说明还没生成过,接下来执行:
- ssh-keygen -t rsa -b 4096 -C “你的邮箱”
这里需要解释一下,rsa是加密算法,-b 4096是密钥长度,4096位是目前最安全的级别,执行后会问你要不要设置密码短语,直接回车跳过即可,也可以设置一个加强安全级别,一路回车会在用户目录下生成

.ssh文件夹,里面有两个文件:id_rsa是私钥,自己妥善保管;id_rsa.pub是公钥,这才是要填到远程仓库的东西。
执行cat ~/.ssh/id_rsa.pub,复制输出的完整内容,打开你的GitHub或Gitee账号,进入Settings → SSH and GPG keys页面,点击New SSH key,粘贴保存,公钥的内容以”ssh-rsa”开头,整段都是。
验证是否配置成功,执行ssh -T git@github.com,如果是Gitee就执行ssh -T git@gitee.com,看到“Hi,你的用户名!You‘ve successfully authenticated”之类的提示就说明通了,整个git配置ssh的过程不难,唯一容易翻车的是公钥复制不完整,复制的时候注意别漏字符。
关联远程仓库并推送代码
密钥搞定后,关联远程仓库就变得非常简单,在本地项目目录下执行:
- git init 初始化本地仓库
- git remote add origin 你的仓库地址 关联远程仓库
- git add . 暂存所有文件
- git commit -m “首次提交” 提交到本地
- git push -u origin main 推送到远程
首次推送时用-u参数会把本地分支和远程分支关联起来,之后的推送只需要git push就够了,这里提一句,常见报错:“error: remote origin already exists”,说明之前已经关联过远程仓库,用git remote rm origin删掉再重新关联即可。
多平台共存和日常工作流
不少人在公司用GitLab、个人项目用GitHub,同一台电脑上需要隔离两套身份,这就要用到条件配置,在项目根目录放一个名为config的本地配置覆盖全局设置,在对应项目里执行git config user.name和git config user.email单独设置身份即可,还有个方式是通过Host别名隔离SSH密钥,编辑~/.ssh/config文件,给不同域名指定不同的公钥文件,字段大致是Host、HostName、User、IdentityFile,按这个结构写两段就能做到互不干扰。

日常工作中除了push和pull,用的最多的还有git status查看工作区状态、git log –oneline查看提交历史、git branch查看分支列表,Git的分支概念很轻量,创建切换分支的成本几乎为零,多分支开发是标准做法。
遇到代码冲突也别慌,Git会明确标出冲突位置,文件里会出现“<<<<<<<”和“>>>>>>>”的标记,手动保留需要的部分、删掉标记,再执行add和commit就能解决冲突,多数情况下只需要编辑文件然后提交,并不会用到复杂的冲突处理工具。
配置Git常见问题
关于git安装配置最后再收个尾,汇总几个出现频率最高的问题。
是不是每个仓库都要重新配置用户名和邮箱?
不需要,只要用–global参数配置过一次,本机所有仓库默认共享这套身份信息,单项目单独配置是在不同仓库需要不同作者身份的少数场景下才需要做的事,比如一个电脑同时维护公司的私有代码和开源项目。
Windows系统安装Git后没有Git Bash怎么办?
安装时取消勾选了右键菜单就会出现这种情况,重新运行安装包,在Select Components界面勾选Git Bash Here以及“Git GUI Here”两个选项,下一步覆盖安装即可恢复,如果不方便重装,直接去安装目录下的cmd文件夹里双击git.exe启动终端也能用,只是操作体验没右键那么方便。
git配置ssh密钥出错,推送时仍提示输入密码?
大部分情况下是因为公钥没有正确添加到远程仓库,或者添加的不是本机生成的公钥,逐项检查:~/.ssh目录是否生成正确,公钥有没有完整复制,远程仓库里粘贴的区域是否正确注意GitHub的SSH密钥粘贴区和Gitee的位置不太一样,Gitee在头像菜单下的“SSH公钥”设置页面,排除完这些后重新执行ssh -T验证,推送就不再要求密码了。
