Shell / Bash大前端
MacOS 系统安装与使用 Git 方法指南
在 MacOS 系统下安装和使用 Git 的方法。内容包括三种主流安装方式（Xcode 命令行工具、Homebrew、官网安装包），以及从基础到高级的全套操作指南。基础部分涵盖环境配置、仓库创建、文件提交与历史查看；中级部分讲解分支管理、远程仓库协作及冲突解决；高级部分涉及暂存变更、标签管理、忽略文件配置及撤销操作。文末附带常用命令速查表，帮助开发者快速掌握版本控制技能。
在 MacOS 系统下安装和使用 Git 的方法。内容包括三种主流安装方式（Xcode 命令行工具、Homebrew、官网安装包），以及从基础到高级的全套操作指南。基础部分涵盖环境配置、仓库创建、文件提交与历史查看；中级部分讲解分支管理、远程仓库协作及冲突解决；高级部分涉及暂存变更、标签管理、忽略文件配置及撤销操作。文末附带常用命令速查表，帮助开发者快速掌握版本控制技能。
Git 是一款开源的分布式版本控制系统，能够高效地跟踪文件变更、管理代码版本，是软件开发、文档协作等场景的核心工具。与集中式版本控制系统不同，Git 支持本地完整版本库存储，无需依赖网络即可完成大部分操作，同时具备强大的分支管理、协同开发能力，广泛应用于 GitHub、GitLab 等代码托管平台。在 macOS 系统中，Git 提供了多种安装方式，且操作逻辑与其他系统保持一致，本文将从安装到高级应用逐步讲解使用方法。
macOS 下安装 Git 有 3 种主流方式，推荐根据自身需求选择，其中 Homebrew 安装 最便捷，适合大多数用户。
macOS 自带的 Xcode 开发工具包含 Git，即使未安装完整 Xcode，也可单独安装其命令行工具：
Terminal 快速启动）；git --version，若输出类似 git version 2.39.3 (Apple Git-145) 的版本信息，说明安装成功。输入以下命令，系统会自动提示安装 Command Line Tools：
git --version
Homebrew 是 macOS 下的包管理器，可快速安装/更新 Git，适合需要最新版本或自定义配置的用户：
git --version，输出类似 git version 2.45.1 的信息即成功（版本号可能随更新变化）；后续更新 Git 可执行：
brew update && brew upgrade git
安装完成后，执行以下命令安装 Git：
brew install git
若未安装 Homebrew，先在终端执行以下命令安装（需联网，过程约 5-10 分钟）：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
适合习惯图形化安装的用户，步骤如下：
.dmg 安装包（自动适配 Intel/Apple Silicon 芯片）；git --version，输出版本信息即成功。初级使用聚焦「本地版本控制」核心功能，包括配置、创建仓库、提交变更、查看历史等，适合单独开发场景。
安装后需配置用户名和邮箱，用于标识提交记录（与代码托管平台账号一致更佳）：
查看配置是否生效：
git config --list
输出中应包含上述配置的 user.name 和 user.email。
配置邮箱（替换为你的邮箱）：
git config --global user.email "[email protected]"
配置用户名（替换为你的名称）：
git config --global user.name "Your Name"
仓库（Repository）是 Git 存储文件版本的目录，可通过两种方式创建：
初始化仓库，生成 .git 隐藏目录（存储版本信息）：
git init
输出 Initialized empty Git repository in /Users/xxx/Documents/MyProject/.git/ 即成功。
终端中进入需作为仓库的文件夹（例如 Documents/MyProject）：
cd ~/Documents/MyProject # 替换为你的文件夹路径
若需获取远程仓库（如 GitHub 上的项目），使用 git clone 命令：
git clone https://github.com/username/repository-name.git # 替换为远程仓库地址
执行后会在当前目录创建与仓库同名的文件夹，包含完整项目文件和版本历史。
Git 提交变更需经过「工作区 → 暂存区 → 版本库」三步，流程如下：
test.txt），或修改已有文件；git add test.txt（替换为文件名）git add .（推荐，. 表示当前目录所有文件）git status，会显示 nothing to commit, working tree clean，表示工作区与版本库一致。提交到版本库（生成永久版本记录，需填写提交说明，描述变更内容）：
git commit -m "首次提交：添加 test.txt 文件"# 引号内为提交信息，需简洁明了
查看文件状态：
git status
输出中会标记「未跟踪文件（Untracked）」或「已修改文件（Modified）」；
如需查看过往提交记录，执行：
git log
输出内容包含：提交 ID（一串字母数字）、提交者、提交时间、提交说明；
git log --onelineq 键。中级使用聚焦「协同开发」核心功能，包括分支管理、远程仓库关联、拉取/推送代码等，适合多人协作场景。
分支相当于项目的「平行副本」，可在分支上开发新功能，完成后再合并到主分支，不影响原有代码：
git checkout maingit merge feature/login（将 feature/login 分支的代码合并到 main）删除分支（合并后无需保留的分支）：
git branch -d feature/login # 删除本地分支
切换回主分支：
git checkout main # 或 master（根据实际主分支名称）
创建并切换到新分支（开发新功能时使用）：
git checkout -b feature/login # 新建分支 feature/login 并切换（推荐）# 等价于：git branch feature/login（创建分支） + git checkout feature/login（切换分支）
查看当前分支：
git branch
输出中带 * 的分支为当前分支（默认主分支为 main 或 master）；
远程仓库是代码的「云端存储中心」，用于多人共享代码，需先在 GitHub/GitLab 注册账号并创建仓库，再进行关联：
git remote -v（首次关联时无输出）；关联远程仓库（替换为你的远程仓库地址，从 GitHub 仓库页面复制 HTTPS 地址）：
git remote add origin https://github.com/username/your-repo.git
（origin 是远程仓库的默认别名，可自定义）
将本地版本库的代码推送到云端：
git push -u origin main # 首次推送，-u 绑定本地 main 与远程 main 分支（后续可简化为 git push）
多人协作时，需先拉取远程最新代码，避免冲突：
git pull origin main # 拉取远程 main 分支的最新代码到本地
若需在另一台设备获取远程仓库代码，直接克隆：
git clone https://github.com/username/your-repo.git # 自动关联远程仓库 origin
当多人修改同一文件的同一部分时，合并会出现冲突，需手动解决：
Automatic merge failed; fix conflicts and then commit the result；<<<<<<<=======>>>>>>>），保留需要的代码；git add 冲突文件名 → git commit -m "解决合并冲突：保留本地与远程核心逻辑"；git push。打开冲突文件，会看到类似以下标记：
<<<<<<< HEAD（当前分支的代码） 本地修改的内容 ======= 远程分支的代码 >>>>>>> origin/main（远程分支名称）
高级使用聚焦「效率优化」和「问题修复」，包括暂存变更、标签管理、忽略文件、撤销操作等，适合提升开发效率。
开发中若需切换分支，但当前工作区代码未完成不想提交，可使用 stash 暂存：
git stash drop stash@{0}（未恢复时删除）恢复暂存的变更（回到原分支后）：
git stash apply stash@{0}# 恢复第 0 个暂存（根据 stash list 显示的索引）# 恢复并删除暂存：git stash pop stash@{0}（推荐，避免暂存列表冗余）
查看暂存列表：
git stash list
暂存当前工作区变更：
git stash
暂存后工作区恢复干净，可切换分支；
标签用于标记重要版本（如发布版本 v1.0.0），方便后续回溯：
删除标签：
git tag -d v1.0.0 # 删除本地标签
git push origin --delete v1.0.0 # 删除远程标签
推送标签到远程仓库：
git push origin v1.0.0 # 推送单个标签
git push origin --tags # 推送所有标签
查看标签：
git tag # 列出所有标签
git show v1.0.0 # 查看标签详情
创建标签（在当前提交创建标签）：
git tag v1.0.0 # 轻量标签（仅标记提交）# 带说明的标签（推荐，更详细）：git tag -a v1.0.0 -m "版本 1.0.0：首次正式发布"
部分文件（如日志、缓存、IDE 配置文件）无需纳入版本控制，可通过 .gitignore 文件过滤：
git add .gitignore 和 git commit -m "添加 .gitignore 文件"，后续这些文件将不会被 Git 跟踪。编辑 .gitignore，添加需要忽略的文件/目录（每行一个），示例：
# 忽略日志文件 *.log # 忽略缓存目录 node_modules/ # 忽略 IDE 配置文件 .idea/ .vscode/ # 忽略系统隐藏文件 .DS_Store
在仓库根目录创建 .gitignore 文件：
touch .gitignore
git checkout -- test.txt # 撤销 test.txt 文件的工作区修改（恢复到最近一次 commit 状态）
git reset HEAD test.txt # 将 test.txt 从暂存区撤回到工作区
git reset --soft HEAD~1 # 撤销最近一次 commit，保留工作区和暂存区修改（可重新提交）# 注意：--soft 保留修改，--hard 会删除修改（谨慎使用！）
git commit --amend # 打开编辑器修改提交说明，保存后覆盖最近一次提交
当提交记录较多时，可筛选日志快速定位：
查看某两次提交之间的差异：
git diff 提交 ID1 提交 ID2 # 对比两个提交的代码差异（提交 ID 可通过 git log 查看）
查看指定文件的修改历史：
git log -- test.txt # 查看 test.txt 文件的所有提交记录
查找包含特定关键词的提交：
git log --grep "登录功能"# 查找提交说明包含「登录功能」的记录
| 命令 | 功能说明 | 示例 |
|---|---|---|
git --version | 查看 Git 版本 | git --version |
git config --global user.name | 配置全局用户名 | git config --global user.name "Your Name" |
git config --global user.email | 配置全局邮箱 | git config --global user.email "[email protected]" |
git config --list | 查看所有配置 | git config --list |
git init | 初始化本地仓库 | cd ~/MyProject && git init |
git clone <url> | 克隆远程仓库 | git clone https://github.com/username/repo.git |
git status | 查看文件状态（未跟踪/已修改/已暂存） | git status |
git add <file> | 添加单个文件到暂存区 | git add test.txt |
git add . | 添加当前目录所有变更到暂存区 | git add . |
git commit -m "<msg>" | 提交暂存区变更到版本库 | git commit -m "添加登录功能代码" |
git log | 查看提交历史 | git log |
git log --oneline | 简化显示提交历史 | git log --oneline |
git branch | 查看本地分支 | git branch |
git branch <name> | 创建本地分支 | git branch feature/pay |
git checkout <branch> | 切换分支 | git checkout main |
git checkout -b <name> | 新建并切换分支 | git checkout -b feature/chat |
git merge <branch> | 合并指定分支到当前分支 | git merge feature/chat |
git branch -d <branch> | 删除本地分支（已合并） | git branch -d feature/chat |
git remote -v | 查看远程仓库关联 | git remote -v |
git remote add origin <url> | 关联远程仓库 | git remote add origin https://github.com/username/repo.git |
git push -u origin <branch> | 首次推送本地分支到远程 | git push -u origin main |
git push | 推送已关联分支的变更 | git push |
git pull origin <branch> | 拉取远程分支最新代码 | git pull origin main |
git stash | 暂存当前工作区变更 | git stash |
git stash list | 查看暂存列表 | git stash list |
git stash apply <index> | 恢复指定暂存 | git stash apply stash@{0} |
git stash pop <index> | 恢复并删除暂存 | git stash pop stash@{0} |
git tag <tagname> | 创建轻量标签 | git tag v1.0.0 |
git tag -a <tagname> -m "<msg>" | 创建带说明的标签 | git tag -a v1.0.0 -m "正式发布 1.0 版本" |
git tag | 查看所有标签 | git tag |
git push origin <tagname> | 推送标签到远程 | git push origin v1.0.0 |
git checkout -- <file> | 撤销工作区文件修改 | git checkout -- test.txt |
git reset HEAD <file> | 撤销暂存区文件（回到工作区） | git reset HEAD test.txt |
git commit --amend | 修改最近一次提交说明 | git commit --amend |
git log --grep "<keyword>" | 按关键词筛选提交历史 | git log --grep "修复 bug" |
git diff <commit1> <commit2> | 对比两次提交的差异 | git diff a1b2c3d e4f5g6h |
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online