⚠️

重要前提

安装AI Skills的关键前提是：必须科学上网，且开启TUN模式，这一点至关重要，直接决定安装能否顺利完成，在此郑重提醒三遍：科学上网，科学上网，科学上网。查看完整安装教程 →

Git Worktree 使用指南：多分支并行开发与高效工作流管理

git-worktree by kimny1143/claude-code-template

55 周安装量

GitHub

安装命令

npx skills add https://github.com/kimny1143/claude-code-template --skill git-worktree

开发命令行工具版本控制

🇨🇳中文介绍

git-worktree - Git Worktree 操作

用于同时处理多个分支的 Git worktree 管理。

概述

使用 Git worktree 可以从一个仓库创建多个工作目录。

优点 :

无需切换分支即可并行开发多个功能
在 PR 评审期间可以进行其他工作
可以同时进行生产环境热修复和开发工作

基本命令

创建 Worktree

# 在新分支上创建
git worktree add ../project-feature-x feature-x

# 在现有分支上创建
git worktree add ../project-hotfix hotfix/urgent-fix

# 检出远程分支
git worktree add ../project-review origin/feature-y

列出 Worktree

git worktree list

输出示例:

/path/to/project          abc1234 [main]
/path/to/project-feature  def5678 [feature-x]
/path/to/project-hotfix   ghi9012 [hotfix/urgent-fix]

删除 Worktree

# 删除工作目录
rm -rf ../project-feature-x

# 从 Git 中注销
git worktree prune

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

1. 功能开发期间进行热修复

# 当前: 正在 feature-x 分支上进行开发
# 紧急: 生产环境出现 bug

# 创建用于热修复的 worktree
git worktree add ../project-hotfix -b hotfix/login-fix main

# 进行热修复工作
cd ../project-hotfix
# ... 修复 ...
git commit -m "fix: resolve login issue"
git push origin hotfix/login-fix

# 返回原始工作
cd ../project
# 继续 feature-x 的工作

# 使用 worktree 打开要评审的分支
git fetch origin
git worktree add ../project-review origin/feature-y

# 进行评审
cd ../project-review
npm install
npm run dev

# 评审完成后
cd ../project
git worktree remove ../project-review

project/              # 主目录 (main)
project-feature-x/    # 功能开发
project-hotfix/       # 热修复
project-review/       # PR 评审

# 确认不需要的 worktree
git worktree list

# 删除已合并分支的 worktree
git worktree remove ../project-merged-feature

# 整理孤立的 worktree
git worktree prune

无法在多个 worktree 中打开同一个分支
需要在每个 worktree 中单独安装 node_modules
也需要复制 .env 文件

"already checked out" 错误

# 分支正在另一个 worktree 中使用
git worktree list  # 确认在何处使用

# 手动删除目录时
git worktree prune

# 无法删除正在 worktree 中使用的分支
# 需要先删除 worktree
git worktree remove ../project-feature
git branch -d feature

🇯🇵日本語

git-worktree - Git Worktree 操作

複数ブランチを同時に作業するための Git worktree 管理。

概要

Git worktree を使うと、1つのリポジトリから複数の作業ディレクトリを作成できる。

メリット :

ブランチ切り替えなしで複数機能を並行開発
PRレビュー中に別作業が可能
本番ホットフィックスと開発を同時進行

基本コマンド

Worktree 作成

# 新規ブランチで作成
git worktree add ../project-feature-x feature-x

# 既存ブランチで作成
git worktree add ../project-hotfix hotfix/urgent-fix

# リモートブランチをチェックアウト
git worktree add ../project-review origin/feature-y

Worktree 一覧

git worktree list

出力例:

/path/to/project          abc1234 [main]
/path/to/project-feature  def5678 [feature-x]
/path/to/project-hotfix   ghi9012 [hotfix/urgent-fix]

Worktree 削除

# 作業ディレクトリを削除
rm -rf ../project-feature-x

# Git から登録解除
git worktree prune

または一括:

git worktree remove ../project-feature-x

ワークフロー例

1. 機能開発中にホットフィックス

# 現在: feature-x ブランチで開発中
# 緊急: 本番バグ発生

# ホットフィックス用 worktree 作成
git worktree add ../project-hotfix -b hotfix/login-fix main

# ホットフィックス作業
cd ../project-hotfix
# ... 修正 ...
git commit -m "fix: resolve login issue"
git push origin hotfix/login-fix

# 元の作業に戻る
cd ../project
# feature-x の作業を継続

2. PRレビュー

# レビュー対象のブランチを worktree で開く
git fetch origin
git worktree add ../project-review origin/feature-y

# レビュー
cd ../project-review
npm install
npm run dev

# レビュー完了後
cd ../project
git worktree remove ../project-review

ベストプラクティス

ディレクトリ命名

project/              # メイン (main)
project-feature-x/    # 機能開発
project-hotfix/       # ホットフィックス
project-review/       # PRレビュー

定期クリーンアップ

# 不要な worktree を確認
git worktree list

# マージ済みブランチの worktree を削除
git worktree remove ../project-merged-feature

# 孤立した worktree を整理
git worktree prune

注意点

同じブランチを複数 worktree で開けない
node_modules は各 worktree で別途インストール必要
.env ファイルもコピーが必要

トラブルシューティング

"already checked out" エラー

# 別の worktree で使用中のブランチ
git worktree list  # どこで使われているか確認

孤立した worktree

# ディレクトリを手動削除した場合
git worktree prune

ブランチ削除時

# worktree で使用中のブランチは削除できない
# 先に worktree を削除する
git worktree remove ../project-feature
git branch -d feature

Weekly Installs

Repository

kimny1143/claud…template

First Seen

Feb 9, 2026

Security Audits

Gen Agent Trust HubFail SocketPass SnykPass

Installed on

claude-code51

gemini-cli22

opencode21

github-copilot21

codex21

antigravity20

React 组合模式指南：Vercel 组件架构最佳实践，提升代码可维护性

125,600 周安装

Git Worktree 使用指南：多分支并行开发与高效工作流管理

🇨🇳中文介绍

git-worktree - Git Worktree 操作

概述

基本命令

创建 Worktree

列出 Worktree

删除 Worktree

相关 Skills

工作流示例

1. 功能开发期间进行热修复

2. PR 评审

最佳实践

目录命名

定期清理

注意事项

故障排除

"already checked out" 错误

孤立的 worktree

删除分支时

🇯🇵日本語

git-worktree - Git Worktree 操作

概要

基本コマンド

Worktree 作成

Worktree 一覧

Worktree 削除

ワークフロー例

1. 機能開発中にホットフィックス

2. PRレビュー

ベストプラクティス

ディレクトリ命名

定期クリーンアップ

注意点

トラブルシューティング

"already checked out" エラー

孤立した worktree

ブランチ削除時

最新 Skills