---
service: "Publicasta"
schema_version: "1.0"
article_id: 881
title: "GitHub Desktop 3.6.7 修复了让 worktree 变得棘手的边缘问题"
language: "zh"
default_language: "en"
canonical_url: "https://publicasta.com/open_source_radar/github_desktop_3_6_7_worktree_edge_cases?lang=zh"
json_url: "https://publicasta.com/open_source_radar/github_desktop_3_6_7_worktree_edge_cases.json?lang=zh"
api_url: "https://publicasta.com/api/public/v1/channels/open_source_radar/articles/github_desktop_3_6_7_worktree_edge_cases?lang=zh"
channel_url: "https://publicasta.com/api/public/v1/channels/open_source_radar"
channel_articles: "https://publicasta.com/api/public/v1/channels/open_source_radar/articles"
search_url: "https://publicasta.com/api/public/v1/search"
documentation_url: "https://publicasta.com/api-docs#reading-publicasta"
openapi_url: "https://publicasta.com/api-docs/openapi.json"
published_at: "2026-10-14T13:38:50+00:00"
updated_at: "2026-10-14T13:38:50+00:00"
translations:
  - language: "ar"
    html_url: "https://publicasta.com/open_source_radar/github_desktop_3_6_7_worktree_edge_cases?lang=ar"
    markdown_url: "https://publicasta.com/open_source_radar/github_desktop_3_6_7_worktree_edge_cases.md?lang=ar"
    json_url: "https://publicasta.com/open_source_radar/github_desktop_3_6_7_worktree_edge_cases.json?lang=ar"
  - language: "de"
    html_url: "https://publicasta.com/open_source_radar/github_desktop_3_6_7_worktree_edge_cases?lang=de"
    markdown_url: "https://publicasta.com/open_source_radar/github_desktop_3_6_7_worktree_edge_cases.md?lang=de"
    json_url: "https://publicasta.com/open_source_radar/github_desktop_3_6_7_worktree_edge_cases.json?lang=de"
  - language: "en"
    html_url: "https://publicasta.com/open_source_radar/github_desktop_3_6_7_worktree_edge_cases?lang=en"
    markdown_url: "https://publicasta.com/open_source_radar/github_desktop_3_6_7_worktree_edge_cases.md?lang=en"
    json_url: "https://publicasta.com/open_source_radar/github_desktop_3_6_7_worktree_edge_cases.json?lang=en"
  - language: "es"
    html_url: "https://publicasta.com/open_source_radar/github_desktop_3_6_7_worktree_edge_cases?lang=es"
    markdown_url: "https://publicasta.com/open_source_radar/github_desktop_3_6_7_worktree_edge_cases.md?lang=es"
    json_url: "https://publicasta.com/open_source_radar/github_desktop_3_6_7_worktree_edge_cases.json?lang=es"
  - language: "fr"
    html_url: "https://publicasta.com/open_source_radar/github_desktop_3_6_7_worktree_edge_cases?lang=fr"
    markdown_url: "https://publicasta.com/open_source_radar/github_desktop_3_6_7_worktree_edge_cases.md?lang=fr"
    json_url: "https://publicasta.com/open_source_radar/github_desktop_3_6_7_worktree_edge_cases.json?lang=fr"
  - language: "pl"
    html_url: "https://publicasta.com/open_source_radar/github_desktop_3_6_7_worktree_edge_cases?lang=pl"
    markdown_url: "https://publicasta.com/open_source_radar/github_desktop_3_6_7_worktree_edge_cases.md?lang=pl"
    json_url: "https://publicasta.com/open_source_radar/github_desktop_3_6_7_worktree_edge_cases.json?lang=pl"
  - language: "ru"
    html_url: "https://publicasta.com/open_source_radar/github_desktop_3_6_7_worktree_edge_cases?lang=ru"
    markdown_url: "https://publicasta.com/open_source_radar/github_desktop_3_6_7_worktree_edge_cases.md?lang=ru"
    json_url: "https://publicasta.com/open_source_radar/github_desktop_3_6_7_worktree_edge_cases.json?lang=ru"
  - language: "zh"
    html_url: "https://publicasta.com/open_source_radar/github_desktop_3_6_7_worktree_edge_cases?lang=zh"
    markdown_url: "https://publicasta.com/open_source_radar/github_desktop_3_6_7_worktree_edge_cases.md?lang=zh"
    json_url: "https://publicasta.com/open_source_radar/github_desktop_3_6_7_worktree_edge_cases.json?lang=zh"
---

# GitHub Desktop 3.6.7 修复了让 worktree 变得棘手的边缘问题

> GitHub Desktop 3.6.7 是一次面向并行检出的维护更新：它让当前 worktree 持续可见，安全处理以短横线开头的引用，修复 Cygwin 路径问题，并避免 Git LFS 进度跟踪崩溃。

GitHub Desktop 3.6.7 是一次目标非常实际的小版本更新：它针对的是图形化 Git 客户端需要同时表示同一仓库多个检出目录的场景。本版本新增了保持当前 worktree 可见的设置，修复了以短横线开头的名称处理问题，解决了“在 Cygwin 中打开”的路径错误，并处理了 Git LFS 进度跟踪中的崩溃。

 ![一张编辑风格的笔记本电脑和整齐项目文件夹照片，象征多个相互关联的 Git 工作树。](https://publicasta.com/storage/projects/10/pages/881/2026/10/b7302cd1-7397-4d9d-94fc-ebfd6382ba07.webp)

 这些改动没有改变 GitHub Desktop 的基本定位。它仍然是围绕 Git 构建的桌面客户端，而不是 Git 仓库模型的替代品。它的价值更具体，也更实用：如果你的日常工作涉及并行分支、关联 worktree、大文件，或名称不太规整的仓库，3.6.7 会减少几种界面妨碍工作的方式。

 因此，对于经常使用 worktree 的维护者和开发者来说，这是一个值得测试的版本。但它不应成为未经验证就改变稳定团队流程的理由；升级仍应在每个操作系统上分别检查，也不能把 GitHub Desktop 当成完整的 worktree 管理环境。项目自己的变更日志和发布标签将其描述为一次聚焦的维护更新，而 Git 文档则说明，仍然存在的一些注意事项来自结构性约束，而不是界面细节。

 ## 3.6.7 改了什么

 官方的 [3.6.7 发布标签](https://github.com/desktop/desktop/releases/tag/release-3.6.7) 列出了四组变化。

 首先，以短横线开头的分支、远程仓库和标签名称，现在可以在 fetch、push、checkout、merge、rebase 以及 worktree 操作中被正确处理。像 `-maintenance` 这样的名称并不常见，但 Git 仓库确实会遇到在命令行边界上不太好处理的名称。图形化应用仍然必须安全地把这些名称传给 Git，并区分参数与选项。这个修复的重要性不在于多数团队会使用以短横线开头的名称，而在于它一次性关闭了多个工作流中的一类输入歧义。

 其次，本版本修复了仓库文件夹包含空格或标点符号时“在 Cygwin 中打开”的集成问题。这类错误在命名谨慎的测试目录中可能完全看不出来，却会立刻影响真实的 Windows 用户目录。仓库可能有效，shell 也可能已经安装，但只要路径拼接或引用方式不正确，集成仍然会失败。发布说明写得很简短，但范围很清楚：路径是数据，桌面集成必须原样保留它们。

 第三，Git LFS 进度跟踪在遇到文件读取错误时不再导致客户端崩溃。这不会让底层文件变得可读，也不会免除对存储、权限或损坏检出的调查。它意味着进度报告失败后，客户端不应再被一并拖垮。对于通过 Git LFS 保存二进制文件、设计资源、数据集或其他大型对象的仓库，这是本次更新中最直接面向可靠性的修复。

 最后，新的 Appearance 设置增加了 Always show worktree list 选项，可以让当前 worktree 的工具栏区域持续显示。早期 beta 变更日志说明了预期行为：即使其余列表被折叠，当前 worktree 控件仍会保留。仓库只有一个检出时，这个差异听起来很小；但当一个仓库有多个关联检出，而用户需要在提交前确认当前活动目录时，它就很有用。

 本版本还包含桌面维护更新中常见的小幅打磨：checks 摘要中的成功和失败图标具有更好的对比度，clone 对话框会验证 macOS 应用程序包路径。这些不是头条功能，却符合本版本的整体方向。3.6.7 关注的是让边界条件更易读，也更不脆弱。

 ## 为什么 worktree 设置值得关注

 Git worktree 并不是通常意义上的额外克隆。[Git worktree 文档](https://git-scm.com/docs/git-worktree)描述了一个主工作树以及零个或多个关联工作树：它们共享大部分仓库数据，同时让 HEAD 和 index 等状态保持分离。实际使用时，同一个仓库可以在一个目录检出功能分支，在另一个目录检出发布分支，还可以在第三个目录检出临时调查分支，而不必把完整对象数据库下载三遍。

 这种模型尤其适合经常切换上下文的工作。维护者可以保持发布分支干净，同时在另一个目录审阅拉取请求。开发者可以让长时间运行的测试或本地服务器留在一个 worktree 中，再到另一个目录处理缺陷。自动化编码工具也让 worktree 更常见，因为它们经常为并行任务创建隔离检出。文件系统布局虽然不同，但人的问题相同：多个目录看起来像同一个项目，而错误可能落在错误的目录中。

 如果客户端只有在打开菜单后才显示当前 worktree，每次操作都会多出一点不确定性。仓库只有一个检出时，这种不确定性并不明显；当目录名称相似、分支生命周期很短，或工具创建出 `work`、`app`、`checkout` 之类的通用目录名时，它的代价就会上升。

 新的持续显示功能本身不能解决身份识别问题。GitHub Desktop 仍然需要提供足够的路径或分支上下文，让用户区分不同 worktree；当前 issue tracker 也表明，这依然是活跃的可用性问题。有一个未关闭的问题建议：当多个树共享相同的文件夹 basename 时，在悬停时显示 worktree 的完整路径。这提醒我们，保持列表可见提升的是可发现性，并不是完整的命名方案。

 因此，正确的理解应当保持克制。这个变化让人更不容易忘记当前上下文，但它不保证所选目录就是你想要的目录，也不能取代在不可逆操作前检查分支和路径。

 ## 这个版本建立在 Git 自身的约束之上

 有些 worktree 方面的意外，客户端无法完全修复。Git 有意在多个 worktree 之间共享 refs 和对象，同时维护每个 worktree 独有的状态。文档指出，HEAD 和 index 是分离的，但许多 ref 仍然共享。一个分支通常一次只能在一个 worktree 中检出；除非用户明确强制执行，否则 Git 会拒绝某些操作。

 这一区分解释了为什么 worktree 可以很省空间，却仍然要求使用者保持纪律。创建第二个检出并不会创建一个完全独立的仓库。fetch 可以更新共享的远程跟踪 ref。除非启用 worktree 专属配置，否则配置可能仍然共享。即使源代码目录彼此分开，钩子、生成文件、构建缓存和环境文件也可能表现得像是属于同一个更大的项目。

 清理规则同样重要。Git 会把关联树的管理信息记录在仓库的 worktrees 目录中。如果有人在文件管理器里直接删除 worktree 文件夹，元数据可能会保留，直到被 prune。支持的做法是：对干净的树使用 `git worktree remove`，或者先确认缺失的树确实已经删除，再使用 `git worktree prune`。如果目录被手动移动，`git worktree repair` 可以重新连接元数据。

 GitHub Desktop 可以更清楚地呈现这些状态，但不能安全地改变它们。如果用户把可见的 worktree 列表理解成一组完全独立的克隆，仍然可能误判共享分支、配置或对象存储。这个版本应当与 Git 模型配合使用，而不是替代 Git 模型。

 ## 以短横线开头的名称修复，解决的是解析问题

 以短横线开头的名称很容易被当成一种不该使用的命名习惯。但这种看法忽略了修复背后的工程问题。许多命令行程序用短横线引入选项。当一个有效的分支、远程仓库、标签或路径也以短横线开头时，构造命令的每一层都必须保留“值”和“标志”之间的区别。

 客户端可以通过多种方式处理这一点：谨慎使用参数数组，在支持的地方明确加入选项结束标记，进行验证，或组合使用这些技术。对用户而言，重要结果是：普通操作不应把仓库名称重新解释成命令选项。

 3.6.7 说明的覆盖范围值得注意。修复并不局限于 checkout，还涵盖 fetch、push、merge、rebase 和 worktree 操作。这说明问题值可能经过多条命令路径。仓库看起来可能一切正常，直到某个远程仓库或标签具有同样的命名形态。修复整组操作，比只修补一个明显的菜单项目更有价值。

 维护者仍应把不常见的 ref 名称当作兼容性测试。如果项目的自动化、发布脚本、托管钩子或文档假设每个分支名称都是由斜线分隔的常规单词，那么桌面客户端只是系统的一部分。3.6.7 降低了一种客户端风险，但不会让每个第三方集成都变得健壮。

 一组小型测试就足以验证行为，不必把它变成生产实验：

 - 创建一个一次性仓库，并建立一个以短横线开头的分支。
- 在涉及共享远程仓库之前，先在本地执行 fetch、checkout、merge 和 rebase。
- 只有在仓库策略允许时，才尝试使用相同形态的远程仓库或标签。
- 确认团队使用的命令行界面和 Web 界面对该 ref 名称的理解一致。
- 检查完成后，干净地删除测试 ref。

 重点不是推荐使用以短横线开头的名称，而是确认一个已经存在这类名称的仓库仍然可操作。

 ## Git LFS：崩溃修复不是存储诊断

 Git LFS 改变了仓库的故障边界。Git 会在普通历史中保存指针文件，大型内容则由 LFS 服务器管理，并在需要时下载。因此，进度指示器处在用户界面、本地文件系统、Git 进程和 LFS 传输之间。读取错误可能来自权限、文件消失、杀毒软件干预、网络挂载目录、磁盘已满，或传输本身的问题。

 3.6.7 处理的是客户端对其中一种错误的响应：进度跟踪不应让应用崩溃。这一点很有用，因为崩溃会摧毁上下文。用户可能看不到当前操作状态，还要自行判断传输是完成、失败，还是留下了部分文件。客户端能够继续运行，就可以显示错误，并让用户检查仓库。

 把它描述成 LFS 数据完整性保证是错误的。这是报告路径上的韧性改进。升级后，团队仍应在测试仓库或非关键检出中验证大文件操作，尤其是在使用网络共享、外置磁盘、激进端点安全策略或特殊文件系统权限的机器上。

 如果传输失败，不要反复重试而跳过基础检查。确认磁盘空间和写入权限，检查路径是否本地且稳定，查看 LFS 日志和仓库配置的端点，并用项目平常的构建或资源验证流程检查检出。图形化应用仍然打开是有帮助的，但这不能证明对象已经完整。

 GitHub Desktop 的开源性质也有助于问责。[仓库](https://github.com/desktop/desktop)是公开的，变更日志记录了 issue 引用，应用元数据则将项目标记为 MIT 许可。该许可允许在遵守项目商标限制以及捆绑依赖项许可证的前提下检查和复用代码。但它不构成支持合同，也不保证每个集成在所有平台上都表现一致。

 ## Open in Cygwin 与路径这个不起眼但重要的边界

 Cygwin 修复属于一类更广泛的桌面软件故障：应用理解 Windows 路径，目标 shell 期待类 POSIX 路径，而两者之间的边界又包含空格或标点。名为 `Open Source` 的目录，或包含括号的文件夹，对文件系统而言都很普通，却经常让启动器在引用路径时出错。

 对用户来说，实际问题是修复后的集成是否适合自己的目录布局。若仓库位于包含空格、括号、方括号、与号或非 ASCII 字符的路径中，升级后应测试该菜单操作。测试时不要使用一次性仓库，但也不要把第一次验证放在正在发布的检出上。确认 Cygwin 打开的是预期目录，并确认 shell 看到的文件与桌面客户端一致。

 这个变化也说明，GUI 发布说明有时看起来比它们修复的故障小。功能本身只是一个菜单操作，但失败可能阻断依赖 Windows 类 Unix 工具链的完整工作流。可靠的路径传递属于基础设施，即使它不是令人兴奋的新功能。

 从客户端启动的脚本也应遵循同样的谨慎原则。不要假设当前工作目录就是足够的上下文。脚本应解析仓库根目录，处理空格，并在路径不存在时给出可见诊断。应用可以传入正确路径；被调用的工具仍然必须正确消费它。

 ## 谁应当优先更新

 最适合尽快更新的是这样一类开发者：在 GitHub Desktop 中使用多个关联 worktree，使用 Git LFS，在 Windows 上使用 Cygwin，或拥有不常见 ref 名称的仓库。这些用户最接近受影响的路径，也最容易判断修复是否符合实际工作流。

 第二类是要为不同操作系统的贡献者提供环境的维护者。一个消除特定路径或名称故障的版本可能降低支持负担，但与其把桌面更新当成普遍解决方案，不如明确发布项目经过测试的版本和设置要求。

 对于在稳定机器上使用单一检出的用户，紧迫性较低。本文引用的说明没有宣称大型新功能，也没有把本版本描述成安全响应。作为正常维护进行更新仍然合理，但在受控环境中，如果没有兼容性检查，打断现有流程的收益有限。

 更安全的推广方式是分阶段进行：

 1. 在一台能够代表团队真实工作流的机器上安装 3.6.7。
2. 打开包含关联 worktree 的仓库，确认当前 worktree 仍然可见。
3. 执行正常的分支、提交、fetch、push 和拉取请求流程。
4. 如果相关，从包含空格的路径测试一次 LFS 传输和 Open in Cygwin 操作。
5. 如果团队支持多个平台，分别检查 macOS、Windows 和 Linux。
6. 完成这些检查后，再更新面向贡献者的文档基线。

 这个版本足够小，上述过程应该很快完成；它也足够具体，以至于普通 smoke test 可能恰好漏掉它修复的那些问题。

 ## GitHub Desktop 仍然不是什么

 GitHub Desktop 不是 Git 命令行的完整替代品。它不会隐藏 worktree 与 clone 的区别，也不能替你决定某个分支应当共享、删除、锁定还是 prune。高级仓库维护仍应交给 Git 命令和项目自己的运维文档。

 它也不是 Cygwin 的完整终端替代品。修复后的集成只是打开另一个环境，并没有把 Windows 与 POSIX 路径语义统一到所有工具中。混用 PowerShell、Git Bash、Cygwin、WSL、容器和原生构建工具的团队，应当明确记录路径假设。

 它同样不是仓库内容的安全边界。打开仓库可能触发钩子、渲染不受信任的数据、调用外部工具，或根据工作流与凭据交互。变更日志中的改进很有价值，但普通防护仍然适用：检查仓库脚本，限制凭据，保持依赖更新，并将实验性检出与敏感环境分开。

 最后，开源并不意味着发行包的每一部分都拥有相同许可证。仓库将应用标记为 MIT 许可，而依赖项和 GitHub 商标各自有不同条款。组织若要重新分发修改后的构建，应查看仓库许可证文件、第三方声明和品牌规则，不能仅凭“开源”二字得出笼统的法律结论。

 ## 依赖 worktree 较多的团队可以考虑的替代方案

 第一个替代方案是 Git 命令行本身。它完整暴露 worktree 模型，也是 add、list、lock、move、repair、prune 和 remove 等操作的参考点。即使团队大多数日常工作在 GUI 中完成，重度依赖 worktree 的团队也应掌握这些命令。

 第二个方案是明确支持多根目录和 worktree 的编辑器或 IDE。它的优势在于代码、终端、测试和语言工具彼此接近；代价是界面可能让用户更容易同时打开多个文件夹，却较少显示共享的 Git 状态。团队应统一命名约定和工作区标签。

 第三个方案是专用 worktree 管理器或一小组 shell 脚本。它们可以规定目录布局，创建可预测的名称，并删除过期树。但它们也会增加新的维护面。一台机器上方便的脚本，换到另一台机器后可能因假设路径布局、删除脏树，或忽略锁和未跟踪文件而变得危险。

 当团队希望使用可视化客户端处理日常 GitHub 操作，同时接受 Git 的 worktree 规则时，GitHub Desktop 3.6.7 最合适。它是一个有用的中间层，而不是抹去仓库状态的抽象层。

 ## 实际结论

 如果 worktree、Git LFS、Cygwin 或不常见的 ref 名称属于你的日常工作，GitHub Desktop 3.6.7 值得测试。可见的 worktree 设置改善了上下文，短横线名称修复关闭了一类真实的参数处理错误，Cygwin 修复让常见的 Windows 路径边界不再那么脆弱，而 LFS 改动则避免文件读取错误直接拖垮客户端。

 对其他人来说，这是一次低调的常规维护更新。这个版本更值得注意的地方，是它显示出桌面 Git 客户端正承受哪些压力：并行检出越来越普遍，仓库包含更多生成内容和二进制内容，开发者也不断在图形化环境与终端环境之间切换。

 安装后，测试与你的仓库真正相关的边缘场景。提交前查看活动 worktree，保持分支和路径名称可见，删除或修复目录时使用 Git 自己的 worktree 命令。把 LFS 崩溃修复理解为韧性提升，而不是验证步骤。这样就足以获得 3.6.7 的价值，也不会要求一个小版本承诺它没有承诺的更多事情。

 ## 来源

 - [GitHub Desktop 3.6.7 发布说明](https://github.com/desktop/desktop/releases/tag/release-3.6.7)
- [GitHub Desktop 变更日志](https://github.com/desktop/desktop/blob/development/changelog.json)
- [GitHub Desktop 源码仓库与许可信息](https://github.com/desktop/desktop)
- [git-worktree 文档](https://git-scm.com/docs/git-worktree)
- [关联 worktree 在下拉菜单中难以区分](https://github.com/desktop/desktop/issues/22211)
- [在悬停时显示 worktree 完整路径](https://github.com/desktop/desktop/issues/22946)