一、前置认知：为什么需要Git工作环境？

• 追踪代码修改历史，随时回滚到任意版本
• 支持多人并行开发，优雅解决代码合并冲突
• 管理多版本迭代，如开发分支、发布分支的隔离
• 对接远程仓库（GitHub、Gitee等），实现代码共享与备份

二、跨平台安装：Windows/macOS/Linux全指南

2.1 Windows系统安装（推荐Windows 10及以上）

1. 下载安装包：优先选择Git官网（ git-scm.com）或国内Gitee镜像站（网速更快），根据系统位数选择64位或32位安装包（如Git-2.45.2-64-bit.exe）。
2. 执行安装向导：双击安装包后按以下关键选项配置，其余默认即可： 许可协议：直接点击"Next"接受GPL协议
3. 安装路径：建议默认路径（C:\Program Files\Git），避免中文路径
4. 环境变量配置：选择"Recommended"选项，将Git添加到系统PATH中，支持在Command Prompt、PowerShell和Git Bash中使用
5. 换行符设置：选择"Checkout Windows-style, commit Unix-style line endings"，适配跨平台开发需求
6. 终端选择：推荐默认的"Git Bash Here"，兼顾Unix命令和Windows操作
7. 验证安装：右键桌面选择"Git Bash Here"，输入git --version，若显示版本信息（如git version 2.45.1.windows.1）则安装成功。

2.2 macOS系统安装

1. 方式一：Homebrew安装（推荐）若未安装Homebrew，先在终端执行：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2. 安装Git：终端执行brew install git，Homebrew会自动处理依赖并配置环境变量
3. 方式二：官方安装包：从Git官网下载macOS版本安装包，双击后按向导完成安装，默认会配置好环境变量。
4. 验证安装：打开终端输入git --version，显示版本信息即成功。

2.3 Linux系统安装（以Ubuntu为例）

1. Ubuntu/Debian系列：终端执行sudo apt update && sudo apt install git -y，通过APT包管理器安装最新稳定版
2. CentOS/RHEL系列：终端执行sudo yum install git -y（CentOS 7及以下）或sudo dnf install git -y（CentOS 8及以上）
3. 验证安装：输入git --version，显示版本信息即完成安装。

三、核心配置：让Git"认识"你并适配开发习惯

3.1 基础身份配置（必做）

# 全局配置用户名（替换为你的名称，如"Zhang San"）
git config --global user.name "Your Full Name"
# 全局配置邮箱（替换为你的邮箱，如"zhangsan@example.com"）
git config --global user.email "your.email@example.com"
# 查看配置结果，确认是否生效
git config --list

3.2 体验优化配置（推荐）

# 开启颜色显示，让命令输出更易读
git config --global color.ui auto
# 设置默认分支名为main（现代开发主流命名，替代传统master）
git config --global init.defaultBranch main
# Windows专属：自动转换换行符（解决跨平台文件格式问题）
git config --global core.autocrlf true
# 配置默认编辑器（以VS Code为例，需确保已安装并添加到环境变量）
git config --global core.editor "code --wait"
# 配置提交模板（可选，规范提交信息）
git config --global commit.template ~/.gitmessage

3.3 配置文件位置说明

• 局部配置：项目根目录.git/config，仅当前项目生效
• 全局配置：用户主目录~/.gitconfig（Windows为C:\Users\用户名\.gitconfig），所有项目生效
• 系统配置：/etc/gitconfig（Linux/macOS）或Git安装目录/etc/gitconfig（Windows），所有用户生效

四、远程仓库连接：实现代码共享与协作

4.1 SSH密钥生成与配置

1. 生成SSH密钥对：打开终端（Git Bash/终端）执行以下命令，全程按回车默认配置即可：ssh-keygen -t ed25519 -C "your.email@example.com"执行完成后，密钥对会生成在用户主目录的.ssh文件夹中：私钥id_ed25519（不可泄露）和公钥id_ed25519.pub（可公开）。
2. 获取公钥内容： Linux/macOS：终端执行cat ~/.ssh/id_ed25519.pub，复制输出的完整内容
3. Windows：在Git Bash中执行上述命令，或直接打开C:\Users\用户名\.ssh\id_ed25519.pub文件复制内容
4. 配置到远程仓库：以GitHub为例，进入"Settings > SSH and GPG keys"，点击"New SSH key"，粘贴公钥并保存。
5. 验证连接：终端执行ssh -T git@github.com，首次连接输入"yes"确认，显示"Hi 用户名! You've successfully authenticated..."即成功。

4.2 备选方案：HTTPS连接配置

# 缓存凭据15分钟（Linux/macOS）
git config --global credential.helper cache
# 永久缓存凭据（Windows）
git config --global credential.helper wincred
# 自定义缓存时间（如1小时，单位秒）
git config --global credential.helper 'cache --timeout=3600'

五、实战验证：创建第一个本地仓库并提交代码

# 1. 创建项目目录并进入
mkdir my-first-git-project
cd my-first-git-project
# 2. 初始化Git仓库（生成.git隐藏目录）
git init
# 3. 创建测试文件和基础结构
echo "# 我的第一个Git项目" > README.md  # 项目说明文档
mkdir src tests  # 源码目录和测试目录
echo -e "*.log\nnode_modules/\n.env" > .gitignore  # 忽略不需要跟踪的文件
# 4. 将文件添加到暂存区（标记要提交的修改）
git add .
# 5. 提交到本地仓库，填写提交信息（描述本次修改内容）
git commit -m "初始化项目：创建基础结构和文档"
# 6. 查看提交历史，验证提交是否成功
git log

六、常见问题排查与解决方案

• 问题1：终端输入git命令提示"不是内部或外部命令"原因：环境变量未配置正确。解决方案：Windows重新运行安装程序，选择"Recommended"环境变量选项；Linux/macOS检查是否通过官方包管理器安装，或手动将Git安装目录添加到PATH中。
• 问题2：SSH连接远程仓库提示"Permission denied"原因：公钥未正确配置或私钥权限过高。解决方案：重新检查公钥是否完整复制到远程仓库；Linux/macOS执行chmod 600 ~/.ssh/id_ed25519修改私钥权限。
• 问题3：提交时提示"user.email"未配置原因：未完成基础身份配置。解决方案：重新执行3.1节的用户名和邮箱配置命令。

七、总结与后续学习方向