目录前言一、什么是 Git Worktree二、两种创建工作树方式命令行 VS Code 可视化方式 1命令行方式 2VS Code 原生可视化操作三、嵌入式项目推荐 worktree 目录规范四、完整开发工作流示例五、重点避坑清单六、对比三种多分支方案优劣七、个人配置总结结语互动讨论前言相信不少开发者都遇到过这样的场景 正在feature/uart-optimize分支开发串口优化功能代码写到一半测试反馈主线main分支存在紧急 Bug 需要修复。传统 Git 开发流程只能二选一git stash暂存当前半成品代码切换分支修复 Bug完成后切回来恢复复制整个项目仓库两份目录分别对应不同分支但是占用大量磁盘空间同步更新麻烦。第一种方式容易忘记 stash、冲突频发第二种会产生两份独立.git仓库维护成本很高。 而Git worktree工作树就是专门解决该痛点的方案新版 VS Code 已经原生内置可视化支持无需安装第三方插件。同一个远端仓库只保存一份 Git 数据库同时创建多个独立工作目录每个目录绑定不同分支互不干扰真正做到多分支并行开发。一、什么是 Git WorktreeGit 2.5 版本引入 worktree 功能核心逻辑一个主仓库包含完整.git数据库保存所有提交记录、分支、标签多个附属工作树目录仅存放源码文件不复制完整 git 数据库节省磁盘空间每个工作目录固定绑定一个分支同一分支不能同时在多个工作树检出通俗来说一份代码仓库本体“分出多个文件夹分身”每个文件夹可以跑不同分支。修改、编译、调试完全隔离分支之间切换不再需要覆盖本地文件。典型适用场景新功能开发中并行处理线上紧急 hotfix需要同时对比两个分支代码实现差异多版本并行调试一边维护稳定版本一边迭代新特性嵌入式项目main稳定版本、feature新功能分支、hotfix修复分支同时编译测试。二、两种创建工作树方式命令行 VS Code 可视化方式 1命令行进入主仓库根目录执行命令# 基础语法git worktree add [目标目录路径] [分支名] # 创建hotfix工作树目录放在主仓库同级 git worktree add ../worktree-hotfix hotfix/v1.3-bugfix # 创建新分支并同时生成工作树-b git worktree add ../worktree-new-feature -b feature/spi-driver常用管理命令# 查看当前所有工作树列表 git worktree list # 删除不再使用的工作树推荐命令删除不要手动删文件夹 git worktree remove ../worktree-hotfix方式 2VS Code 原生可视化操作打开主仓库项目进入「源代码管理」面板在仓库一栏点击右上角...更多操作选择Worktrees Create Worktree弹窗选择目标分支设置新工作目录保存路径确认自动创建创建完成后可以直接在 VS Code 新窗口打开该目录独立编辑、运行、调试。 最佳实践每个工作树目录使用独立 VS Code 窗口打开终端、编译环境、调试配置完全隔离避免混淆。三、嵌入式项目推荐 worktree 目录规范我在项目中长期使用这套目录结构方便管理project-root/ # 主仓库main分支 ├── worktree-feature/ # worktree新功能分支 └── worktree-hotfix/ # worktree紧急修复分支规则所有附属工作树统一放在主仓库同级目录命名规范worktree-分支名称一眼区分用途。四、完整开发工作流示例当前在project-root主仓库feature 分支开发驱动收到线上 Bug执行命令创建 hotfix 工作树git worktree add ../worktree-hotfix main -b hotfix/uart-fixVS Code 单独打开worktree-hotfix目录基于主线修复问题、编译、测试修复完成提交代码、推送远端合并到 main 分支不再需要时执行git worktree remove ../worktree-hotfix清理目录切回原 feature 窗口继续新功能开发全程不需要暂存、覆盖本地代码。五、重点避坑清单禁止手动删除 worktree 文件夹 手动删除目录后Git 内部依然保留该工作树记录后续创建同名工作树会报错。必须使用git worktree remove正常卸载。同一个分支不能同时绑定多个工作树Git 不允许一个分支在多个目录同时检出防止文件冲突。如果需要并行测试同一分支不同配置只能复制完整仓库。附属工作树没有独立.git 文件夹 打开 worktree 目录你只会看到.git文件是一个指向主仓库的链接不是文件夹不要误删。谨慎在 worktree 之间直接拷贝文件 分支之间代码同步优先使用cherry-pick、merge等 Git 标准操作手动复制容易丢失提交记录。嵌入式注意编译产物隔离 每个工作目录独立编译建议将.o、可执行文件、build 产物加入.gitignore避免跨目录干扰。六、对比三种多分支方案优劣方案优点缺点适用场景git stash 切换分支无需额外目录零空间占用半成品代码容易遗忘、频繁暂存冲突多临时简单修改完整复制仓库完全隔离自由度最高占用双倍磁盘同步麻烦长期维护互不相关大版本Git worktree共享 git 数据库、节省空间分支隔离仅支持不同分支并行绝大多数日常开发推荐首选七、个人配置总结结合嵌入式 C 工程开发我的标准化配置方案优先使用 VS Code 可视化创建工作树减少记忆命令成本所有临时 hotfix、长期 feature 全部通过 worktree 创建独立目录不同工作树独立 VS Code 窗口打开区分终端项目.gitignore统一屏蔽编译中间文件任务完成后及时执行git worktree remove清理废弃目录避免堆积紧急修复优先基于 main 分支新建 hotfix 工作树不污染正在开发的 feature 代码。结语很多开发者长期依赖stash切换分支饱受上下文混乱的困扰。Git worktree 并不是冷门黑科技而是提升多任务并行效率的实用工具搭配新版 VS Code 原生支持后上手门槛大幅降低。尤其是嵌入式开发者工程编译耗时久、环境配置复杂频繁切换分支重新编译会浪费大量时间。借助工作树多个分支可以同时保持编译环境随时切换调试极大提升开发流畅度。如果你还在反复暂存代码来回切分支不妨尝试这套 worktree 工作流。互动讨论你平时开发中如何处理多分支并行开发有没有遇到 Git 切换分支带来的各种麻烦欢迎评论区交流 worktree 使用踩坑经验