Git 跨平台完全指南：安装、提交、推送及 CI/CD 触发实战（Windows/Linux/macOS）

最新推荐文章于 2026-06-22 23:54:59 发布

原创最新推荐文章于 2026-06-22 23:54:59 发布 · 63 阅读

1 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

标签

#git #ci/cd #windows #linux #macos

前言：无论你是在 Windows 上使用图形化工具，还是在 Linux/macOS 下敲击命令行，Git 都是每个开发者必须掌握的基础技能。不仅如此，现代开发流程中，一次 git push 往往还会触发 CI/CD（持续集成/持续部署）自动构建。

本文将摒弃枯燥的理论，带你从零开始：

在 Windows、macOS、Linux 三大系统上完成 Git 的安装与初始配置。
以 Windows 下的 TortoiseGit（小乌龟）图形界面为主视角，演示代码修改、提交、推送的完整闭环。
展示 Push 代码后如何自动触发 Jenkins 构建。
同步提供 Linux/macOS 下的命令行等价命令，让你在任何系统下都能无缝切换。

安全声明：文中所用截图均已对仓库地址、邮箱等敏感信息做马赛克脱敏处理，仅保留技术操作界面。

第一章：三大主流操作系统安装 Git

在进行任何 Git 操作之前，请确保 Git 已正确安装在你的电脑上。

1. Windows 系统

独立安装：访问 Git 官网，下载 .exe 安装包，按向导安装即可。建议在“选择默认编辑器”步骤中选 VSCode 或 Notepad++。
包管理器安装（推荐）：若使用 Windows 11 或已安装 winget，可直接在 PowerShell 中执行：
```
winget install --id Git.Git -e --source winget
```

全局配置（必须）：安装完成后，打开 Git Bash，设置你的身份信息：

git config --global user.name "Your Name"
git config --global user.email "your_email@example.com"

2. macOS 系统

Homebrew 安装（推荐）：
```
brew install git
```

验证与配置：

git --version
git config --global user.name "Your Name"
git config --global user.email "your_email@example.com"

3. Linux 系统（Ubuntu / CentOS 为例）

Ubuntu/Debian：

sudo apt update
sudo apt install git -y

CentOS/RHEL：

sudo yum install git -y
# 或使用 dnf（新版）
sudo dnf install git -y

验证安装（见图 6）：安装完毕后，终端输入 git --version，若显示具体版本号（如 git version 2.47.3），则说明安装成功。

第二章：实战场景与操作示例

为了直观展示操作流程，我们以一个典型的日常代码修改为例：

开发者需要修改项目根目录下的 package.json 文件，对其中一行构建命令进行调整（新增 1 行配置，删除旧的 1 行配置），随后提交并推送至远程仓库的某个特性分支（示例分支名为 V1.8.8）。

接下来，我们分别在 Windows（图形化） 和 Linux/macOS（命令行） 下完成这套操作。

第三章：Windows 图形化操作全流程（TortoiseGit）

TortoiseGit 是 Windows 下最受欢迎的 Git 图形客户端，它与资源管理器无缝集成。

步骤 1：克隆仓库与切换分支

在文件夹空白处右键 → Git Clone，输入仓库 URL 克隆代码。
进入项目目录，右键 → TortoiseGit → Switch/Checkout，在弹出框中输入目标分支名（如 V1.8.8），点击 OK 切换。

步骤 2：修改文件

使用编辑器打开 package.json，修改 scripts 字段中的命令，保存文件。此时文件图标会显示为红色感叹号（表示已修改但未暂存）。

步骤 3：本地提交（Commit）

右键项目根目录 → Git Commit -> “分支名”…，弹出提交窗口。
Message 区域填写清晰的提交说明，例如：补充 SSR 服务端构建命令。
在下方的变更列表中，可以看到 package.json 的状态为 Modified，且统计显示 Lines added: 1，Lines removed: 1。
点击 Commit，完成本地提交。

步骤 4：推送到远程（Push）

右键 → TortoiseGit → Push。
确认本地分支与远程分支对应无误（此处为 V1.8.8），点击 OK。
推送成功后，会弹出提示窗显示 Success 和耗时（如图所示，本次推送耗时 1657ms）。同时，远程仓库（如 GitLab）会在返回信息中贴心地附上一个创建 Merge Request 的链接，方便后续发起代码评审。

步骤 5：在远程仓库（GitLab）验证提交结果

推送完成后，我们打开浏览器进入 GitLab 远程仓库页面，可以看到两个不同维度的变化，这两张图需要结合来看：

仓库根目录文件列表（旧提交的快照）：
这是项目根目录下的文件和文件夹列表（如 public、scripts、src 等）。请注意，这里显示的“最后提交”时间均为 “3小时前”。
这说明：展示的是本次新提交之前的代码仓库状态。因为新提交只修改了 package.json，并未改动 public、scripts 等目录，所以这些目录的“最后提交时间”依然停留在 3 小时前，并不会因为本次推送而改变。
特定文件（package.json）的提交历史（新提交的痕迹）：
当我们点击进入 package.json 文件，并查看其提交历史（History）时，才会看到最新变化。
如图所示，package.json 的历史记录顶端赫然出现了刚刚推送的提交信息——“补充 SSR 服务端构建命令”，且时间显示为 “1分钟前”。同时，文件变动统计清晰地标出了 1 addition 和 1 deletion。
这说明：精确地捕捉到了本次代码变更，它与旧提交的时间差（3小时前 vs 1分钟前）正好印证了本次提交只修改了这一个文件。

在这里插入图片描述

步骤 6：查看本地提交历史（Show Log）

推送完成后，我们可以在本地通过 TortoiseGit 的日志功能查看提交记录：

右键 → TortoiseGit → Show Log，弹出日志查看窗口。
在日志列表中，最顶端 即为刚刚提交的记录，提交信息为 补充 SSR 服务端构建命令，作者和日期清晰可见。
点击该提交记录，下方文件列表 会精确显示本次修改了哪些文件。如图所示，只有 package.json 被改动，状态为 Modified，且行数统计为 Lines added: 1，Lines removed: 1。
左下角状态栏显示当前分支共有 113 个版本（revision），从最早的 4dd96944 到最新的 87dcd070。本次选中的正是最新的一次提交。

💡 小贴士：Show Log 是开发中高频使用的功能，它不仅能查看历史，还能对比不同版本之间的差异、追溯某行代码是谁写的（Blame 功能），是排查问题的利器。

第四章：Push 后自动触发 CI/CD（Jenkins）

在现代 DevOps 流程中，代码推送到远程仓库后，通常会自动触发构建。这通过 Git 仓库的 Webhook 机制与 Jenkins 集成来实现。

当代码被推送到远程分支后，Jenkins 会自动拉取最新代码并执行构建任务。
如图所示，Jenkins 构建历史中生成了新的任务 #149，状态为绿色（成功）。
在 变更记录（Changes） 中，Jenkins 会准确捕获到本次提交的 Message（补充 SSR 服务端构建命令），并关联具体的提交哈希值（Revision）。开发者若发现构建失败，可依据此信息快速定位到对应的代码变更。

这一环节实现了代码提交即交付的自动化流水线。
在这里插入图片描述

第五章：Linux / macOS 命令行等价操作

对于服务器运维或偏好命令行的开发者，无需图形界面。下表列出了与上述 Windows 操作完全等价的 Shell 命令。

操作目标	Linux / macOS 命令行
克隆仓库	`git clone git@gitlab.com:your-project.git`
切换分支	`git checkout V1.8.8` （若本地无则加 `-b` 参数）
查看当前状态	`git status` （会列出修改的文件）
暂存修改	`git add package.json`
本地提交	`git commit -m "补充 SSR 服务端构建命令"`
推送到远程	`git push origin V1.8.8`
查看提交日志	`git log --oneline --graph -5` （紧凑显示最近5条）
验证 Git 版本	`git --version`

在这里插入图片描述

跨平台换行符注意事项：
Windows 默认换行符为 CRLF，Linux/macOS 为 LF。为避免构建脚本因换行符报错（如 \r: command not found），建议在 Linux 服务器上设置 git config --global core.autocrlf input，让 Git 在提交时自动将 CRLF 转换为 LF。

第六章：总结

至此，你已经掌握了：

在 Windows、macOS、Linux 三大平台上安装和配置 Git 的方法。
通过 Windows 下的 TortoiseGit 图形界面完成从修改到推送的完整闭环操作，并学会区分“仓库目录列表”与“文件专属提交历史”这两个不同的远程仓库视图。
理解 Git Push 后如何无缝触发 Jenkins 自动构建，形成 CI/CD 闭环。
掌握 Linux/macOS 下对应的命令行操作，真正做到“一次学习，多平台通用”。

无论你习惯敲键盘还是点鼠标，Git 的核心理念都是共通的——规范化的提交信息、清晰的分支策略、自动化的交付流水线，这些才是保证项目健康迭代的基石。