Golang-告别繁琐的 git checkout！用 git-wt 实现多分支并行开发，彻底解决上下文切换焦虑

icy 昨天 25 抢沙发

默认

摘要： 在日常的软件开发流程中，我们经常会遇到这样的场景：你正在 feature-A 分支上开发一个复杂的功能，代码写到一半，突然接到了一个紧急的 Bug 修复请求，需要立即切换到 hot...

在日常的软件开发流程中，我们经常会遇到这样的场景：你正在 feature-A 分支上开发一个复杂的功能，代码写到一半，突然接到了一个紧急的 Bug 修复请求，需要立即切换到 hotfix 分支。

此时，你面临两个选择：要么执行 git stash 将当前进度暂存，切换分支，修复 Bug，再切回来 git stash pop；要么提交一个带有 “wip”（work in progress）字样的临时 commit。虽然这些方法可行，但在处理多个并行任务时，频繁的切换会导致严重的“上下文丢失”，且容易在 stash 堆栈中搞混版本。

git-wt 正是为了解决这个痛点而生的 Golang 工具。它通过利用 Git 的 worktree 特性，让你能够为每个分支创建独立的物理工作目录，实现真正的“并行开发”。

什么是 Git Worktree？

在深入 git-wt 之前，我们需要理解 Git 原生的 git worktree 命令。

通常情况下，一个 Git 仓库只有一个工作区（Working Tree）。当你切换分支时，文件系统中的文件会被替换。而 git worktree 允许你在同一个仓库中拥有多个工作区。这意味着你可以同时在文件夹 A 中运行 main 分支，在文件夹 B 中运行 develop 分支，而无需在两者之间来回切换。

git-wt 则是对这一强大功能的极简封装，旨在通过更简单的命令行交互，让 Worktree 的管理变得像切换文件夹一样自然。

git-wt 核心功能与优势

git-wt 将复杂的 git worktree add 和 git worktree list 等命令简化为了高效的快捷操作。其核心价值在于：

零成本上下文切换：无需 stash，无需临时 commit。直接进入另一个目录即可开始工作。
并行运行与测试：你可以同时启动两个不同分支的服务，对比运行结果，而不需要重启整个环境。
轻量化管理：它通过 Golang 编写，运行速度极快，且无需复杂的依赖安装。
结构化组织：自动管理工作区的路径，避免手动创建目录带来的混乱。

安装指南

由于 git-wt 是用 Go 语言编写的，你可以通过以下方式快速安装：

text

# 使用 go install 安装
go install github.com/k1LoW/git-wt@latest

安装完成后，确保你的 $GOPATH/bin 已添加到系统的 PATH 环境变量中。

实战实例：从场景出发

假设你正在开发一个名为 my-project 的项目，目前处于 main 分支。

场景一：快速开启一个新功能分支

你需要开发一个名为 user-auth 的新功能，但不想破坏当前 main 分支的干净状态。

传统做法： git checkout -b user-auth $\rightarrow$ 修改代码 $\rightarrow$ (突然需要回 main) $\rightarrow$ git stash $\rightarrow$ git checkout main。

使用 git-wt：

text

# 创建并切换到 user-auth 的独立工作区
git-wt add user-auth

执行该命令后，git-wt 会在你的项目根目录同级（或指定位置）创建一个名为 user-auth 的文件夹。你只需要 cd user-auth，在这个文件夹里，你处于 user-auth 分支，且所有的修改都独立于主目录。

场景二：紧急修复 Bug

当你正在 user-auth 文件夹中写代码时，突然需要修复 main 分支的一个 Bug。

操作流程： 1. 直接打开一个新的终端窗口。 2. cd 进入原有的 main 项目目录。 3. 直接修改代码 $\rightarrow$ git commit $\rightarrow$ git push。 4. 回到 user-auth 目录继续开发。

整个过程无需任何 checkout 或 stash 操作，两个分支在物理空间上完全隔离。

场景三：清理不再需要的任务

当 user-auth 功能开发完成并合并到主分支后，你不再需要这个独立的工作区。

操作流程：

text

# 删除指定的工作区
git-wt rm user-auth

该命令会安全地移除工作区目录并清理 Git 的内部引用。

进阶技巧与注意事项

在使用 git-wt 时，有几个关键点需要注意：

1. 依赖管理（Node.js / Go / Python）

由于每个 Worktree 是独立的文件夹，这意味着你的依赖包（如 node_modules 或 vendor）在默认情况下是不共享的。 - 建议：在进入新 Worktree 后，记得运行一次依赖安装命令（如 npm install 或 go mod download）。 - 优势：这保证了不同分支可以使用不同版本的依赖库而不会产生冲突。