企业官网建设流程全解析

2026年了，Git依然是版本管理领域绕不开的基础工具。每年都有新同学在“安装”这一步卡住：下载哪个版本、Windows选项怎么勾、换行符警告怎么处理、第一次提交就被编辑器困住，这些问题单独看都不复杂，凑到一起就能折腾一晚上。这篇保姆级教程准备把Git安装流程和基础使用步骤从头到尾过一遍，覆盖Windows、macOS、Linux三种环境，也把日常高频的核心操作讲透，适合刚入门的新人，也适合想系统梳理一遍操作细节的开发者。

1. 安装前的准备工作：版本选择与安装思路

1.1 为什么2026年还需要一篇安装教程

很多老手觉得“装Git不就是下一步下一步吗”，但实际辅导过新人的朋友都清楚，这里面的坑比想象中多。安装包分32位和64位，Windows有不同终端环境选项，换行符处理策略会直接影响跨平台协作，更别提macOS上那种“看起来装好了，一执行命令又说找不到”的情况了。

Git本身是一个命令行工具，安装完之后，真正要面对的是大量终端操作。新手如果从一开始就没搞清楚自己装的是什么、装完去哪儿验证，后面遇到问题很容易懵。这篇教程会把安装和基础使用放在同一个流程里讲，让读者装完就能跑通第一轮操作，而不是装完之后对着黑窗口发呆。

1.2 如何选择版本和下载渠道

Git的版本号已经发展到了2.x系列，官方稳定版更新频率不算快，版本选择上直接认准“最新稳定版”即可。千万不要去下载测试版或者RC候选版，日常学习和工作用不到那些新功能，稳定版可以减少很多不必要的麻烦。

下载渠道方面需要区分系统看：

• Windows用户推荐从Git官网下载安装包，注意区分64位和32位系统，目前主流的电脑基本都是64位。
• macOS用户可以用官方安装包，也可以使用常见的第三方包管理工具，两条路各有优劣。
• Linux用户则优先使用发行版自带的软件源安装，这条路径最简单也最省心。

不少开发者会遇到官网下载速度波动的问题，这时候可以改用国内的一些开源镜像站点，速度往往更稳定。这里多提一句，无论从哪个渠道下载，装完之后一定要自己验证一下版本号，确认安装成功再继续下一步。

2. 分系统安装实操全流程

2.1 Windows系统安装步骤与细节

Windows是新手群体最集中的系统，安装过程看起来简单，但有几个选项需要特别留意。

第一步，拿到安装包后双击运行，跳出用户账户控制窗口时选择“是”。第二步，进入安装向导后，会看到很多复选框，下面几个最重要：

• 选择编辑器：Git安装包默认会带上Vim，但Vim对新手非常不友好，第一次提交时如果误入了Vim界面，很多人不知道怎么退出。建议在这里直接选择你常用的编辑器，比如VS Code或者记事本。
• 调整PATH环境变量：这里一定要选“Git from the command line and also from 3rd-party software”，这个选项会把Git命令加入系统PATH，保证在CMD、PowerShell和各类IDE里都能直接使用git命令。如果选错了，装完以后在终端里输入git会提示找不到命令。
• 换行符处理方式：默认选项是“Checkout Windows-style, commit Unix-style line endings”，也就是检出时转成Windows换行符，提交时转成LF。这个默认策略在团队协作中比较稳妥，建议保持默认。

安装路径可以改到D盘之类的位置，但不建议路径里出现中文或空格。装完之后重启一下终端，输入git --version，如果能看到版本号，说明安装成功。

2.2 macOS系统安装步骤

macOS安装Git有三条常见路线，新手我建议走包管理器路线，因为后续卸载和更新都很方便。

包管理器的安装方式是一行命令的事情，安装完成后同样用git --version验证。如果你不想用包管理器，也可以直接从官网下载macOS安装包，双击安装即可。还有一条隐藏路线是，直接在终端里输入git命令，系统会弹出提示引导你安装命令行开发者工具，但这个工具包含的版本可能不是最新的，也不一定能满足所有开发场景。

这里还有一个比较容易踩的坑：如果你装了包管理器版Git，系统同时也有自带的Git，终端里执行git时可能会命中其中一个。可以通过which git查看当前到底用的是哪个路径下的Git，如果发现版本不对，排查一下PATH环境变量里哪个路径排在前面。

2.3 Linux系统安装步骤

Linux用户安装Git最推荐使用系统自带的软件源，不同发行版命令略有差异：

• Debian/Ubuntu系使用apt系列命令。
• CentOS/RHEL/Fedora系使用yum或dnf系列命令。

装完之后运行git --version验证。如果软件源里的版本比较旧，也可以考虑从源码编译安装，但日常使用完全没必要，系统源里的版本足够稳定，而且后续安全更新能跟着系统一起走。

Linux装Git还有个额外好处，它一般会自带一个叫作git的系统账户权限体系，但这不是普通用户的范畴，日常开发只需要关注自己的用户级和全局级配置即可。

2.4 安装完成后的自检清单

不管是哪个系统，装完之后都建议做一套统一自检：

1. 打开终端，运行git --version，确认能输出版本号。
2. 运行which git，在Windows上是where git，确认命令路径正确。
3. 输入git help，看一下帮助文档能否正常展示。
4. 随便进入一个空目录，运行git init，看看会不会报错。

如果以上四步都通过，Git安装就算真正完成了。很多同学装完之后就急着往里填文件，结果操作到一半才发现命令根本不存在，这种低级错误用一分钟自检就能避免。

3. 第一次使用前的配置：让Git记住你是谁

3.1 配置用户名和邮箱

Git的提交记录里会包含作者信息，这个信息来自全局配置，不配置的话提交时会报错或者显示奇怪的默认值。新机器上第一步永远是配置用户名和邮箱：

git config --global user.name "你的名字" git config --global user.email "you@example.com"

这里的邮箱不需要跟远程平台的邮箱完全一致，但建议使用同一个，这样提交记录能跟远程账号正确关联起来。如果你在一个项目里需要使用另一个身份，可以去掉--global参数，单独在该项目目录下配置一份。

3.2 选择默认编辑器与换行符策略

提交时如果没有使用-m参数指定提交信息，Git会调用默认编辑器让你输入。如果你没有处理过编辑器配置，默认会指向Vi/Vim。对于不熟悉Vim的人来说，这几乎是第一道劝退门槛，所以在配置阶段就建议这样处理：

git config --global core.editor "code --wait"

把默认编辑器设置为你熟悉的编辑器。设置完成之后，用git config --global -e打开配置文件检查一下，看到core.editor一项已生效即可。

3.3 查看与修改全局配置文件

Git的全局配置保存在用户目录下的.gitconfig文件中，Windows在用户主目录下，macOS/Linux在~/.gitconfig。查看全部配置用：

git config --global --list

如果发现配置值写错了，重新执行一次git config --global写入相同配置项就会覆盖。配置文件本身也是文本文件，直接打开修改也是允许的。注意--global范围是当前用户，不带--global则是针对当前仓库配置，两者优先级不同，仓库级配置会覆盖全局配置。刚上手时建议统一用全局配置，少一个变量就少一个问题。

4. 基础使用流程：从初始化到第一次提交

4.1 两种开始方式：init 与 clone

使用Git建立版本管理有两种入口：一是从零开始初始化一个仓库，二是从远程克隆一个现成仓库。

初始化适用于本地新项目。在项目根目录执行git init，目录里会出现一个隐藏的.git文件夹，这个文件夹保存了版本历史和相关配置，千万不要手动去改里面的文件。

cd my-project git init

克隆适用于参与已有项目。执行git clone加上远程仓库地址，Git会把整个项目和历史记录拉到本地，并且自动建立好远程关联，这是参与团队协作最常用的入口。

4.2 工作区、暂存区、版本库的关系

Git的基础模型是“三个区域”，理解这个模型比背命令更重要。

• 工作区就是你当前看到和编辑的文件目录。
• 暂存区可以理解成一个中转站，用来临时存放你要纳入下一次提交的文件。
• 版本库则保存着每次提交产生的历史快照。

日常操作里，修改文件发生在工作区，通过git add把改动放进暂存区，再用git commit把暂存区内容固化到版本库。绝大多数误操作都源于对这三个区域认知不清，比如改完文件直接commit，结果发现改动没有被包含，就是因为忘了add。

4.3 第一次提交的完整步骤

拿一个全新的目录来演示：

git init echo "# Hello" > README.md git add README.md git commit -m "初始化项目"

执行完git commit后，可以运行git log看提交历史。这里有个值得养成的习惯：提交信息要写清楚目的，不要写“update”或者“改了点东西”这种没信息量的内容。团队协作通常还会约定提交信息的格式，比如要求带上需求编号。

如果执行commit时进入了全屏编辑器，不要慌，输入你的提交信息后，先按Esc，再输入:wq回车保存退出。我已经见过太多新手卡在这一步，甚至直接关掉终端导致提交中断。

5. 日常开发必会的核心操作

5.1 分支管理与切换

分支是Git最强大的功能之一，它能让你在一条独立的线上开发新功能，不影响主分支。基础操作只有几个：

git branch feature-login git checkout feature-login

第一行创建分支，第二行切换到该分支。新版Git用一个命令能同时完成创建和切换：

git switch -c feature-login

查看当前所有分支用git branch，当前分支前会有个星号标记。操作分支时容易踩的问题是：忘记切换分支就在旧分支上乱改，最后把功能写进了错误的分支。解决办法是每次开始写代码前先git status确认当前分支，同时养成“一个分支只做一个改动”的习惯。

5.2 关联远程仓库并推送

本地仓库要在远程平台创建好之后，才能执行关联。远程平台可以是常见的代码托管平台，也可以是公司内部搭建的服务。关联操作如下：

git remote add origin <远程仓库地址> git branch -M main git push -u origin main

第一行把远程地址关联为origin，第二行把本地默认分支重命名为main，第三行首次推送到远程并建立追踪关系。之后再推送直接git push即可。

首次推送经常遇到认证问题，现在的托管平台基本都推荐使用个人访问令牌替代密码，需要提前在平台后台生成并保管好。生成之后可以顺手把令牌加入系统凭据管理器，避免每次推送都重复输入。

5.3 从远程拉取更新与合并

参与协作时，远程仓库的状态会被别人更新，本地仓库需要定期同步。最简单的同步是：

git pull

git pull相当于先执行git fetch（拉取远程新数据），再执行git merge（把新数据合并到当前分支）。如果本地也有未推送的提交，很可能产生合并冲突。

遇到冲突时，Git会在冲突文件里用<<<<<<<、=======、>>>>>>>标记出两边的改动，需要手动去判断保留哪些内容。处理完冲突后重新执行git add和git commit完成合并。这里给新人一个建议：合并前先看当前分支状态，处理完冲突不要急着推送，先用git status确认没有遗漏文件。

5.4 基于需求选择忽略文件的策略

项目中总有些文件不该进入版本库，比如依赖目录、编译产物、本地配置。在仓库根目录建一个.gitignore文件，列出需要忽略的规则：

node_modules/ dist/ *.log .env

注意.gitignore只对尚未被跟踪的文件生效。如果某个文件已经被提交过，就算后来加进忽略规则也不会自动从仓库移除，需要先执行git rm --cached把它从版本库移除。很多人在这块栽过跟头：把密钥文件提交了以后才想起加忽略，结果历史里已经留下了痕迹，处理起来相当麻烦。所以提醒一句，敏感文件要在项目初期就处理掉。

6. 常见问题排查与避坑指南

6.1 换行符引起的无意义改动

在Windows上开发，编辑器默认使用CRLF换行，而Linux/macOS使用LF。如果配置不当，每次拉取代码都会看到大量文件被标记为改动，但打开一看内容没变化。

解决思路是统一换行符配置。最常见做法是让仓库统一保存LF，Windows检出时可以转成CRLF，这个策略对应安装时选择的默认项，也能通过命令显式设置：

git config --global core.autocrlf true

如果团队对换行符要求严格，最好的方式是在仓库根目录添加一个属性文件，对所有文本文件强制指定为LF。配置这类文件的语法是给文件路径追加属性，比如让所有文本文件使用LF。团队协作时，换行符策略应该在项目初始阶段就定好，后期再改非常折腾。

6.2 提交了不该提交的文件

如果不小心把日志、临时文件或者本地配置提交进去了，不要慌，看文件是否已经推送到远程：

• 如果只在本地提交过，可以修改最近一次提交，把误加的文件从暂存区移除后重新提交。
• 如果已经推送到远程，最简单的方式是新增一条提交把它删除，不要试图强行改写历史，因为改写已推送的历史会影响其他协作者。

这里特别提醒，凡是包含密码、密钥、令牌的文件被提交到远程，已经不属于Git操作能解决的问题了，必须立刻去平台侧吊销相关凭据并更换密钥，这一点怎么强调都不过分。

6.3 配置不生效或命令找不到

装了Git之后命令运行时提示找不到，有很大概率是PATH没有设置成功。Windows用户需要重新打开终端让环境变量生效，或者手动检查系统环境变量里是否存在Git路径。

配置了用户信息却提交失败报错，多数是因为只配置了仓库级配置或者根本没写进去。可以用git config --list查看当前生效的所有配置，如果发现某个配置项有多个值，说明全局和仓库级的配置同时在起作用，后者会覆盖前者。

6.4 提交时编辑器操作卡住

执行git commit没带-m，结果终端里弹出了一个全屏界面，很多人会直接关掉窗口。正确的做法是：在键盘上按一下Esc进入命令模式，然后输入:wq回车保存退出。如果只是不想进入这个界面，提交时每次都写上-m即可。

还有一个高频问题是：git commit之后发现提交信息写错了，想改。如果提交还没推送，用git commit --amend重新编辑提交信息即可。已经推送过的提交信息建议不要改，除非你清楚改写历史带来的后果。

我个人在实际操作中最大的体会是：Git的很多坑不是算法复杂，而是概念没理顺。安装只是开始，真正花时间的是理解工作区、暂存区、版本库三者的关系，以及养成查看状态、谨慎提交的习惯。这个工具用顺了之后，日常就是那几个命令来回切换，但每次操作前多看一眼状态，能帮你避开绝大多数麻烦。如果你把这篇教程从头跟到尾，现在已经有了一个能正常使用的Git环境，并且跑通了从初始化到提交、再到分支和远程操作的全流程，剩下的就是在真实项目里多练几遍，用熟为止。