鸳鸯蝴蝶派1. 写给第一次用Git的朋友：这篇教程是怎么来的
大概一个月前，我一个关系特别好的朋友转行做前端，第一天上班就被同事甩了一句“你把代码push一下”。他当时整个人是懵的，跑过来问我：push是啥？代码怎么push？我是不是按了个回车就完事了？
我本来想甩给他一堆官方文档，后来想了想，当年我学Git的时候，被那些术语折磨得够呛——工作区、暂存区、版本库、HEAD、远程分支……名词一个接一个，每个字都认识，连在一起就是看不懂。所以这次我决定换一种方式，用最直白的大白话，给好朋友写一份真正能上手的Git基础操作指南。
这篇教程的目标读者非常明确：完全没接触过Git的纯新手，或者是那种“只会clone和commit，一遇到报错就慌”的半新手。内容覆盖从安装配置、最常用命令、到常见报错排查的完整流程。如果你恰好也是这个阶段，那这篇就是为你写的。
先说清楚Git到底是干嘛的。你可以把Git想象成一个极其严格的“存档管家”，你每完成一个小阶段，就跟它说“帮我存个档”，它就把当前所有文件的状态记下来。以后任何时候，你都可以回到任何一个存档点。多人协作时，每个人都在自己的电脑上改代码，最后把改动合并到一起，Git保证这个过程不混乱、不丢东西。
学Git不需要什么高深基础，只要你：
- 会打开终端（Windows上的cmd、PowerShell，或者Mac的Terminal）
- 知道cd、dir/ls这几个最基础的目录操作命令
- 有要管理的项目文件夹，哪怕是写几篇Markdown笔记也行
满足这三条，你就能跟我朋友一样，花一晚上把这篇内容里的东西全学会，第二天上班就能用上。我写这篇的时候特别控制篇幅，每个命令只讲“它干什么、什么时候用、最容易踩什么坑”，把那些花哨但平时用不到的高级操作全部砍掉，只留刚需。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. Git安装与环境配置：先把“地基”打牢
2.1 Windows和macOS下的安装步骤
我知道很多人一上来就想敲命令，但Git没装好，后面全是白搭。这里直接给出两个主流系统的安装方法。
Windows用户，去Git官网下载安装包，下载的时候注意选择对应系统版本（64位就选64-bit）。安装过程一路Next默认选项即可，但有一步需要注意：默认编辑器建议保留Vim，虽然Vim用起来不友好，但新手阶段你基本碰不到需要打开编辑器的情况，等以后熟悉了再改成VS Code也不迟。
还有一步是调整PATH环境变量的选项，默认的“Git from the command line and also from 3rd-party software”就是对的，千万别改成“Use Git and optional Unix tools from Command Prompt”，那样会把系统自带的某些命令覆盖掉，容易引出奇怪的问题。
macOS用户就简单多了，如果你装了Homebrew，一行命令搞定：
bash复制brew install git
没装Homebrew也没关系，直接去官网下载pkg安装包，双击安装就行。安装完之后，在终端里验证一下：
bash复制git --version
能输出类似 git version 2.39.2 这样的版本号，就说明安装成功了。
2.2 全局配置：改用户名和邮箱，不给GitHub/GitLab添乱
装完Git第一件事不是急着clone代码，而是先告诉Git“你是谁”。Git在提交（commit）的时候，会把你的用户名和邮箱写进提交记录里。如果没配置或者配错了，你的提交记录会显示成一堆乱码名字，同事看了都想打人。
打开终端，执行以下两条命令：
bash复制git config --global user.name "你的名字"
git config --global user.email "你的邮箱"
注意两点。一是--global这个参数，意思是这台机器上所有仓库都用这个身份。如果你在不同平台有不同的身份（比如公司GitLab一个号，GitHub另一个号），那就不加--global，到具体某个仓库目录下单独设置，这样这个仓库里就只认当前目录下的配置。
二是用户名建议用拼音或英文，不要太长也不要带空格。邮箱就填你注册代码平台时用的那个邮箱，这样别人看到你的提交记录才能点进你的主页。
配置完之后，可以用下面这条命令查看当前配置是否生效：
bash复制git config --list
看到user.name和user.email都正确输出了，就说明配置成功。这个步骤虽然简单，但我见过太多新手跳过去，结果每次提交都要手动输入身份信息，甚至提交失败，非常耽误事。
2.3 SSH免密配置：告别每次输入密码的折磨
在讲SSH配置之前说一个很多新手会混淆的地方，Git操作远程仓库有两种常见的方式：HTTPS和SSH。
HTTPS的地址长这样：https://github.com/yourname/repo.git，每次push和pull都可能要输入用户名密码（有些平台支持缓存，