VS Code 怎么切换 Git 分支和 Worktree：状态栏与仓库视图操作

在 VS Code 里，临时切到另一个分支可以直接点底部状态栏；如果要让两个分支同时保留各自文件，则应在 Source Control 的 Repositories 视图创建 Git Worktree。前者改变当前工作区，后者新增一个独立目录，先分清这两个动作，后面的菜单就不容易点错。

步骤一：确认状态栏分支入口和当前仓库

先打开一个已经由 Git 管理的工作区。观察窗口底部 Status Bar，当前分支通常会显示在左侧区域；再点击左侧活动栏的 Source Control 图标，确认面板中确实有当前仓库条目。

这里先检查工作区状态。若 Changes 下有未提交文件，切换分支可能因为文件会被覆盖而被 Git 拒绝；先提交、暂存或使用 Git stash，再继续操作。成功标准是：状态栏有明确分支名，Source Control 面板能定位到同一个仓库。

步骤二：从状态栏切换到已有分支

点击 Status Bar 的分支名称，打开分支选择器。在 Local Branches 区域选择目标分支；如果目标只存在于远程分支，则先确认是否需要创建本地跟踪分支。选择完成后等待编辑器刷新，不要在刷新期间连续点击多个分支。

切换成功后，至少核对两处：底部状态栏显示新分支，Source Control 的仓库标题也显示新分支。编辑器里的文件可能随分支内容改变，这不是 Worktree 创建，而是当前窗口已经切换了工作目录。

步骤三：进入 Source Control Repositories 视图

要管理 Worktree，打开 Source Control 视图中的 Repositories 视图。它会把主仓库以及后续创建的 Worktree 显示为独立的仓库条目。选中目标仓库，找到条目右侧的 More Actions (...) 菜单，再从这里进入 Worktrees。

不要把文件资源管理器、提交历史或普通 Source Control 文件列表当作 Worktree 入口。验收点是：仓库以条目形式出现，条目的操作菜单能继续展开 Worktrees。

步骤四：创建并选择新的 Worktree

在目标仓库条目上点击 More Actions (...)，选择 Worktrees > Create Worktree。VS Code 会依次提示选择分支和保存位置：分支决定新目录开始时的内容，位置决定这个 Worktree 在文件系统中的独立目录。

创建完成后，VS Code 会在所选位置建立新目录，并把目标分支签出到其中。Worktree 共享仓库历史，但不共享工作文件和未提交改动；如果目标分支已在其他 Worktree 中签出，Git 会阻止重复签出，这属于保护机制，不是创建失败后的重试信号。

步骤五：核对 Worktree 条目并打开

回到 Repositories 视图，确认新 Worktree 已作为独立条目出现。右键该条目，可以选择 Open Worktree in Current Window 或 Open Worktree in New Window。需要比较主工作区与 Worktree 的变更时，再使用条目菜单里的 Compare with Workspace。

最后检查窗口标题或工作区路径是否已经指向新目录，同时确认仓库条目显示的是预期分支。主 Worktree 中尚未提交的文件不会自动复制到新 Worktree；需要把改动带回主工作区时，应先比较，再按需求提交、合并或执行迁移操作。

常见问题：切换分支和 Worktree 怎么选

切换分支会创建新的文件夹吗？

不会。状态栏切换只更新当前工作区的签出状态，仍然使用原目录；创建 Worktree 才会增加一个独立工作目录。

为什么分支选择器不允许切换？

最常见原因是未提交文件会被目标分支覆盖。先查看 Changes，提交、暂存或 stash 后再切换，并重新核对目标分支。

两个 Worktree 能使用同一个分支吗？

不能同时签出同一个本地分支。为并行开发创建 Worktree 时，应选择不同分支；它们仍可共享同一仓库历史。

应该打开当前窗口还是新窗口？

只处理一个任务时可打开当前窗口；需要同时观察主分支和功能分支时，选择新窗口更清楚，也更不容易把文件改错。