Git 是一个强大的版本控制解决方案，广泛用于代码版本管理、共享以及复杂任务协作。它通过命令行提供了便捷高效的访问方式。然而，每天重复输入数十次冗长的命令会很快变得繁琐。因此，工程师们提出了一种定义快捷方式的方法，即 Git Alias（Git 别名）。

Git Alias 允许你为任何 Git 操作或一系列操作创建自定义快捷命令。这可以减少你的输入量，并根据你个人或团队的风格定制工作流，从而让开发工作变得更加轻松。

本教程将介绍 Git Alias 是什么、如何使用它们，以及如何负责任地分享它们的技巧。如果你是 Git 新手，建议先学习我们的 Introduction to Git 课程和 GitHub Foundations 学习路径，打下坚实的基础后再深入学习。

Git Alias 基础

在开始创建自定义快捷方式之前，我们先来探讨 Git Alias 是什么、它们如何工作以及它们对开发者为何如此有用。

什么是 Git Alias？

Git Alias 是你在 Git 配置中定义的自定义命令。本质上，它是你最常用 Git 命令的简写。

如果你已经熟悉命令行，你可能会觉得 Git Alias 听起来很像 Shell Alias。但它们之间存在一些重要区别。Shell Alias 是在你的 Shell 配置中定义的快捷方式，可用于任何命令行工具，而不仅仅是 Git。

然而，Git Alias 是在 Git 自身的配置中定义的，并且仅在使用 git 命令时可用。Git Alias 具有可移植性，因为它们随 Git 配置一起移动。这意味着它们可以与你的团队共享，并在不同的环境中保持一致的工作。与 Shell Alias 相比，它们也更容易作为版本控制设置的一部分进行文档化和维护。开发者使用 Git Alias 来节省时间、精力，减少输入错误，并自动化他们的工作流。

如果你对将 Shell 集成到你的工作流中感兴趣，请查看我们的 shell courses 来学习。

作用域与持久性：全局与局部

Git Alias 主要分为两类：全局 Alias（Global Alias）和局部 Alias（Local Alias）。它们的主要区别在于你定义它们的位置以及它们可用的范围。

全局 Alias 在你系统上的每个仓库中都可用。当你设置全局 Alias 时，它会存储在你的全局 Git 配置文件中。这是定义你希望在所有地方使用的快捷方式的最佳位置。

关于使用全局 Alias 的一个快速提示：它们是针对你特定机器的。如果你在不同的机器之间切换，或者帮助同事处理他们自己的机器，这一点很重要。你的全局 Alias 在他们的机器上将不起作用。

另一方面，局部 Alias 仅限于单个仓库。它们存储在该特定仓库的配置文件中。如果你需要项目特定的快捷方式，或者想在不影响全局设置的情况下进行实验，局部 Alias 会很有用。

局部 Alias 的优先级

需要注意的是，如果你在全局和局部都定义了相同的 Alias，那么局部 Alias 具有更高的优先级。这意味着当你身处该局部仓库时，你的计算机将使用局部 Alias，而忽略全局 Alias。一旦你离开该仓库，全局 Alias 将重新生效。这是一个有用的特性，因为它允许你为特定项目覆盖全局默认设置。

关于在不同级别配置 Git 的更多信息，请查看 Intermediate Git。

上图流程图显示，Git 首先在局部配置文件中查找你的 Alias。如果未找到，Git 会检查全局配置文件以确定要运行的命令。

创建与配置 Git Alias

设置 Git Alias 很直接，但你选择的方法可能取决于你的工作流、操作系统和个人偏好。

创建方式

创建 Git Alias 的主要有两种方式：你可以使用命令行创建一个新的 Git Alias，或者直接编辑你的 Git 配置文件。

通过命令行创建

添加 Alias 最简单的方法是使用 git config 命令。通用的语法是：

git config --global alias.<alias_name> "<git_command>"

例如，我们创建一个 git commit -m 的快捷方式，它用于将暂存的更改与消息一起保存到仓库。

git config --global alias.cm "commit -m"

这个命令添加了一个名为 cm 的新 Alias，它会运行 git commit -m。--global 标志指定该 Alias 应在你的所有仓库中可用。如果你省略 --global，该 Alias 将默认为应用于当前仓库的局部 Alias。

一旦你创建了所需的 Alias，你可能想再次检查你创建了哪些。你可以使用命令行查看所有当前定义的 Alias：

git config --global --get-regexp alias

这将列出每个 Alias 及其对应的命令。你也可以检查特定的 Alias。例如，以下命令将从你的配置文件中返回 Alias lg 的值。

git config alias.lg

这是确认你的 Alias 是否设置正确的一种快速方法。

直接编辑配置文件

当你使用上述命令时，你的 Git 配置文件（我们后面将其称为 Git 配置），无论是全局还是局部，都会更新你选择的 Alias。你可以通过直接修改你的配置文件来绕过这个过程。

你需要用文本编辑器打开你的 Git 配置文件，并在 [alias] 部分下添加 Alias。在 Windows 上，全局 Alias 通常在 C:\\Users\\<YourUsername>\\.gitconfig 中找到，或者在仓库中的 .git\\config 中找到局部 Alias。在 macOS 或 Linux 上，全局 Alias 通常在 ~/.gitconfig 中，局部 Alias 在 .git/config 中。

你的 Git 配置文件应该看起来像这样（如果是全局文件，可能包含更多部分）：

[user]
    name = Your Name
    email = your.email@example.com
[alias]
    # Your aliases go here

如果我们向下滚动到 [alias] 部分，我们可以添加自定义快捷方式：

[alias]
    st = status
    co = checkout
    br = branch
    cm = commit -m

这种方法在你希望同时添加多个 Alias 时特别有用。它也使得从同事或在线资源复制粘贴一组 Alias 变得容易。

有关常见 Git 命令的便捷参考，请查看我们的 Complete Git Cheat Sheet。

操作系统与 Shell 特性配置

Git Alias 定义在你的 Git 配置内部，因此它们可以在不同的操作系统和 Shell 中工作。但是，你如何使用它们可能取决于你的环境。

在 Windows 上，Git Alias 在 Git Bash 和 WSL (Windows Subsystem for Linux) 中运行可靠。在命令提示符 (Command Prompt) 和 PowerShell 中，像 st（表示 status）这样的简单 Alias 运行良好，但依赖于 Shell 特性（如管道或多个命令）的复杂 Alias 可能无法按预期运行。对于复杂的 Alias，Git Bash 或 WSL 是更好的选择。

在 macOS 和 Linux 上，Git Alias 通常在 Bash、Zsh 和其他类 Unix Shell 中以相同的方式工作。简单和复杂的 Alias 都可以无问题地使用。

Fish Shell 是一个特例，因为它使用与 Bash 和 Zsh 不同的语法。一些假定 POSIX Shell 语法的复杂 Git Alias 可能无法在 Fish 中正确运行。在这种情况下，你可能需要将 Alias 重写为 Shell 函数，或者坚持使用更简单的 Git Alias。

有关 Shell 基础知识的更多信息，请参阅我们的 Bash & Zsh Shell Terminal Basics Cheat Sheet。

管理 Git Alias

一旦你设置了 Alias，你就需要保持它们井然有序，根据需要更新它们，并解决可能出现的任何冲突。

查看、更新与删除 Alias

我们已经讨论了如何查看 Alias 列表，无论是通过配置文件还是命令行。但如果你想修改或删除一个 Alias 怎么办？幸运的是，这也很简单。要修改一个 Alias，你可以再次运行 git config 命令并提供一个新值，或者直接在你的配置文件中编辑相关行。

删除 Alias 同样简单。在命令行中，你可以使用 --unset 标志来删除一个 Alias：

git config --global --unset alias.cm

或者你可以直接从你的配置文件中删除该行。一旦删除，该 Alias 就不再可用。

处理 Alias 冲突与问题

偶尔，你可能会遇到冲突，例如在全局和局部都定义了相同的 Alias。记住，在同一个仓库中，局部 Alias 会覆盖全局 Alias。因此，如果你发现你常用的 Alias 无法正常工作，你可能需要检查你当前所在的仓库以及是否有任何局部 Alias 被定义。同时，尽量避免使用与内置 Git 命令（如 commit 或 push）重叠的名称也是一个好习惯。

如果你在不同机器之间切换或升级 Git，最好仔细检查你的 Alias 是否仍然有效。在协作时，考虑记录你的 Alias 或共享一个通用的配置文件，以便每个人都能访问相同的快捷方式。

常用 Git Alias 类别与使用场景

让我们来看几种不同类别的 Git Alias，以及它们如何提升你的日常工作效率。

命令缩写

Alias 最明显的用途之一就是缩写长命令或频繁使用的命令。例如，你可以用 git co main 来代替 git checkout main，或者用 git st 来代替 git status。随着时间的推移，这些小小的调整可以为你节省大量的输入时间，让你的工作流感觉更快。

增强输出格式

Git 的原始输出有时很难阅读，特别是 git log 或 git diff 等命令。Alias 允许你改变输出格式，使其更清晰。我们可以定义一个带有颜色、日期和分支的自定义日志视图，或者通过单词高亮使 diff 更易读。这可以让你更容易地发现更改和跟踪历史记录。

例如，我们可以为 git log 创建一个自定义 Alias，以提高输出的可读性：

git config --global alias.lg "log --oneline --graph --decorate --date=short --pretty=format:'%h - (%cd) %an %d %s'"

现在，我们不再键入 git log 并得到以下通用输出：

commit 1a2b3c4 (HEAD -> main)
Author: Your Name <your.email@example.com>
Date:   Mon Oct 18 10:00:00 2025 +0800

    Second commit message

commit 5d6e7f8
Author: Another Name <another.email@example.com>
Date:   Sun Oct 17 09:00:00 2025 +0800

    First commit message

通过使用我们的 Alias git lg，我们可以得到一个更简洁、更易读的输出：

* 1a2b3c4 - (2025-10-18) Your Name (HEAD -> main) Second commit message
* 5d6e7f8 - (2025-10-17) Another Name First commit message

你可以看到我们的 Alias 化输出将显著更容易阅读，特别是当有二十个或更多条目而不是仅仅这两条时。

工作流自动化

Alias 还可以作为 Git 工作流的微型自动化工具。例如，你可以将多个命令组合成一个 Alias，在一个步骤中完成暂存、提交和推送更改。这种类型的自动化会非常有用，特别是对于使用 DevOps 实践并重视一致性的团队。

你可以在 CI/CD for Machine Learning 中了解 Git 如何融入更广泛的自动化工作流。

常用与社区推荐 Alias

有些 Alias 如此流行，以至于它们已成为 Git 社区的常用工具。这些包括快捷方式以及更高级的 Alias，它们让工作变得更轻松。请查看下面的表格，其中列出了我看到的 20 个最常见的 Git Alias。

高级 Git Alias 技巧

除了缩短长命令，还有一些高级的 Alias 技巧，可以提供与你的 Shell 集成、处理参数，甚至为特定仓库定制 Alias 的灵活性。

Shell 命令集成

你可以将 Shell 命令直接集成到你的 Git Alias 中。通过在 Alias 前加上 !，Git 会将其余部分传递给你的 Shell。这开启了将 Git 操作与外部工具结合的可能性，例如在提交之前运行 Linter，或者将多个命令链式执行。如果你是 Shell 环境的新手，Bash & zsh Shell Terminal Basics Cheat Sheet 等资源可以帮助你理解这在实践中是如何工作的。

参数处理

有时你会希望 Alias 不是硬编码的，而是能适应你传递的任何参数。通过将 Alias 编写为匿名的 Bash 函数，你可以接受参数并动态使用它们。这种灵活性让你能将重复性任务转化为简单、可重用的命令，以满足你的需求。

例如，让我们创建一个参数化的 Git Alias，它将搜索我们的提交中的特定文本。在 Windows 上，你可以在 Git Bash 中执行此操作。在 macOS 和 Linux 上，相同的 Alias 也能工作，因为 Git 在 Bash 兼容的 Shell 中运行它。

git config --global alias.find '!f() { git log -i --grep="$1" --pretty=format:"%h - %an, %ar : %s"; }; f'

现在运行 git find bugfix 将会在提交消息中搜索“bugfix”并显示匹配的提交。

条件配置

Git 的 includeIf 指令允许你根据仓库或环境加载不同的 Alias 集。例如，你可能希望为工作项目使用一组 Alias，为个人项目使用另一组。条件配置让你的设置保持井然有序，同时确保在正确的上下文中提供正确的工具。

在你的全局 Git 配置文件中，你可以包含：

[includeIf "gitdir:C:/Users/YourName/work/"]
    path = C:/Users/YourName/.gitconfig-work
[includeIf "gitdir:C:/Users/YourName/personal/"]
    path = C:/Users/YourName/.gitconfig-personal

然后，在 C:/Users/YourName/.gitconfig-work 中，定义 Alias，例如：

[alias]
    lg = log --pretty=format:"%h %ad %s%d" --date=short
    co = checkout

而在 C:/Users/YourName/.gitconfig-personal 中：

[alias]
    co = checkout -b
    br = branch

现在，当你在 C:/Users/YourName/work/ 下的仓库中时，键入 git lg 将使用工作特定的 Alias，而在 C:/Users/YourName/personal/ 中，git co 将使用个人 Alias。然而，如果你使用此系统，记住你所在的目录很重要。你不希望将你的 Alias 混淆！

Mac/Linux 用户注意事项：只需将 Windows 路径替换为 Unix 风格的路径，例如：~/work/ 或 ~/personal/。行为在其他方面是相同的。

维护与协作策略

随着你的 Git Alias 集合的增长，保持清晰和一致变得至关重要，尤其是在协作时。让我们讨论一些文档化、共享和保护 Alias 的最佳实践，以便它们仍然是资产，而不是混乱的来源。

文档化

Git Alias 的正确文档化与开发过程中所有其他部分的文档化一样重要。这份文档对新团队成员和未来的你来说都是无价的。以下是一些策略：

• 在你的项目 README 中维护一个项目特定 Git Alias 的章节。对于每个 Alias，简要描述其目的和用法。
• 直接编辑 .gitconfig 时，在复杂或不明显的 Alias 上方添加注释。例如：

[alias]
    # Log with graph, oneline, decorate, short date and pretty format
    lg = log --oneline --graph --decorate --date=short --pretty=format:'%h - (%cd) %an %d %s'

• 如果你在一个团队中工作，你可能需要考虑标准化团队中使用的 Alias。而且，如果你的团队使用 Wiki 或内部文档平台，请包含一个关于 Git Alias 的页面，并随着项目的发展进行更新。

清晰的文档和沟通确保每个人都理解每个 Alias 的作用，从而降低出错风险，并使其更容易采用新的快捷方式。

安全与验证

另一个需要考虑的重点是安全性。Alias 虽然强大，但如果管理不当，也可能带来风险。例如，执行破坏性操作（如删除分支或强制推送）的 Alias 应该经过仔细考虑，并在非关键数据上进行测试。你最不希望发生的事情是，以为自己正在做一些无害的操作，却意外地从仓库中删除了关键分支！

在使用潜在危险的 Git Alias 时，你可以采用的一个救命措施是 --dry-run 标志。这允许你在实际执行之前预览你建议的操作！例如，假设你想使用 Alias 删除 file.txt。你最好先以空运行的方式执行它，以确保执行了正确的操作。

git rm --dry-run file.txt

另一个潜在的安全隐患是运行 Shell 命令或外部脚本的 Alias。以 ! 开头的 Alias 会在你当前的 Shell 中执行其后的内容，这意味着一个审查不当或不受信任的 Alias 可能会删除文件、窃取数据或执行其他有害操作。同样，调用外部脚本的 Alias 如果脚本来自未经验证的来源或已被修改，也可能存在风险。在使用每个 Alias 之前对其进行审查，并避免盲目从互联网复制 Alias，这一点非常重要。这也是我更喜欢不在同一个 Alias 中混合 Git 命令和 Shell 命令的原因。

总结

Git Alias 是一个强大但经常被低估的功能，可以极大地提高个人和团队的生产力。通过将复杂或重复的命令浓缩成易于记忆的快捷方式，Alias 有助于减少认知负担，最大程度地减少输入错误，并简化你的日常工作流。

如果你有更多问题或想深入了解，请查阅 Complete Git Cheat Sheet 以及本文中链接的其他资源。如果你对简化命令行体验的其他方法感到好奇，你可能还会喜欢 How to Use a SQL Alias to Simplify Your Queries。

关于

关注我获取更多资讯

📢 公众号

💬 个人号