剑客精翻：Claude Code官方教程(05)-并行开发

剑客精翻：Claude Code官方教程(05) 并行开发 剑客精翻：Claude Code官方教程(05) 并行开发 Modified September 4, 2025 提交各个工作树的更改 当各个工作树的开发任务基本完成后，就可以进入测试验证阶段了。这个阶段的主要任务是确保所有功能模块都能正常工作，并且相互之间没有冲突。首先可以在浏览器中验证前端功能的实现效果，然后运行测试套件来确认后端功能的正确性。在这个过程中，我们能够看到代码格式化工具已经正确配置，开发脚本也已成功添加，相关文档也得到了相应的更新。 特别需要注意的是，由于pyproject.toml文件在多个工作树中都有修改，在后续的合并过程中可能会遇到配置冲突的情况。这正是Git工作树技术的优势所在——它能够将这些潜在冲突延迟到合并阶段统一处理，而不是在开发过程中就产生干扰。 当所有工作树的开发任务都达到预期效果后，接下来需要将各个分支的更改正式提交到版本控制系统中。在提交过程中，务必为每个工作树编写清晰详细的提交信息，这样不仅便于后续的版本追踪，更重要的是为即将到来的合并操作提供重要的上下文信息。 对于每个工作树，都需要执行完整的添加和提交操作。首先处理UI功能分支的提交，确保主题切换功能的所有更改都被正确记录。然后对测试功能分支进行同样的操作，将新增的测试用例和框架增强内容提交到版本库。最后完成质量控制功能分支的提交，将代码格式化工具和质量检查脚本的集成工作归档。 在实际工作中，如果经常需要执行"用描述性消息添加并提交"这类操作，完全可以将其封装成自定义命令。通过预定义的命令模板，不仅能够确保提交信息的格式一致性，还能体现公司或团队的Git最佳实践标准。 完成所有工作树的提交操作后，就可以返回主分支开始合并流程了。此时需要关闭各个工作树的终端环境，回到主要的开发环境中进行后续的集成工作。 智能合并所有工作树 在合并阶段，可以直接要求Claude Code使用 git merge 命令来处理trees文件夹中的所有工作树合并，并自动解决可能出现的冲突。这种智能化的合并方式大大简化了复杂的版本控制操作，特别是在处理多分支并行开发的场景下。 合并过程会按照工作树的创建顺序依次进行。首先合并测试功能分支，通常这个分支的合并过程相对简单，因为测试代码与其他功能模块的耦合度较低。接下来合并UI功能分支，这个过程同样比较顺利。 当处理质量功能分支的合并时，由于之前提到的pyproject.toml文件在多个工作树中都有修改，这里确实会出现合并冲突。这时就能看到Claude Code的AI能力在冲突解决方面的价值——它能够智能分析冲突的性质，理解不同更改的意图，然后提供合理的合并方案。对于一些简单的配置冲突，这种自动化处理方式比手动解决要高效得多。 在合并过程中，Claude Code会自动提交所有更改以及冲突解决方案。根据项目需要，可以选择在合并完成后删除工作树，也可以保留它们以备后续使用。系统还会进行快速验证，确保合并后的文件结构和配置信息都符合预期要求。 验证最终结果 在浏览器中测试实际效果时，我们能够看到主题切换功能已经完美实现。浅色主题和深色主题之间的切换流畅自然，用户界面的视觉效果也符合现代化的设计标准。虽然在细节优化方面可能还有一些调整空间，但核心功能已经完全达到了预期目标。更重要的是，整个开发过程展现了Git工作树技术的强大威力——通过合理的并行开发策略，我们成功避免了传统多分支开发中常见的文件冲突和版本管理难题。 通过这种方式，不仅能够高效地处理前端UI开发，还能同时推进后端测试框架的完善以及代码质量工具的集成。这种全栈式的并行开发模式极大地提升了开发效率，为复杂项目的管理提供了一种全新的解决思路。 在下一课中，我们将探索Claude Code在GitHub集成方面的更多可能性，学习如何在终端环境之外进行拉取请求审查和代码协作。 课代表学习笔记 📖 核心内容 本课重点：Git工作树并行开发。通过自定义命令标准化流程，使用工作树技术同时开发UI功能、测试增强和代码质量工具，最终智能合并完成功能集成。避免传统多窗口开发的文件冲突，大幅提升开发效率。 🎯 重点掌握 三个核心技能： 1. 自定义命令创建 ：在 .claude/commands 目录建立markdown文件，使用 $args 变量构建标准化开发流程 2. Git工作树管理 ： git worktree add 命令创建独立工作环境，确保功能模块间完全隔离 3. 智能合并策略 ：利用Claude Code的AI能力处理复杂合并冲突，高效整合多工作树更改 ⚠️ 难点解析 核心挑战：文件冲突处理 多个工作树修改同一文件（如 pyproject.toml ）时容易产生合并冲突。 解决策略： • 合理规划工作树职责边界，避免重复修改同一配置文件 • 利用Claude Code智能合并能力自动分析冲突性质 • 确保每个工作树都有详细的提交信息，便于冲突分析和团队协作 💡 实践要点 • 工作树命令： git worktree add trees/[feature name] [branch name] • 每个工作树运行独立Claude Code实例 • 善用描述性自定义命令提升开发一致性 • 定期 git worktree list 检查工作树状态 • 合并前确保完整提交记录和清晰提交信息 大家可以关注我的公众号🌟（或联系：lanyijianke1992），后台私信"cc资源包"，领取我为大家整理的课外资源💼，持续更新中✅ 我是蓝衣剑客，谢谢你看我的文章。 提交各个工作树的更改 当各个工作树的开发任务基本完成后，就可以进入测试验证阶段了。这个阶段的主要任务是确保所有功能模块都能正常工作，并且相互之间没有冲突。首先可以在浏览器中验证前端功能的实现效果，然后运行测试套件来确认后端功能的正确性。在这个过程中，我们能够看到代码格式化工具已经正确配置，开发脚本也已成功添加，相关文档也得到了相应的更新。 特别需要注意的是，由于pyproject.toml文件在多个工作树中都有修改，在后续的合并过程中可能会遇到配置冲突的情况。这正是Git工作树技术的优势所在——它能够将这些潜在冲突延迟到合并阶段统一处理，而不是在开发过程中就产生干扰。 当所有工作树的开发任务都达到预期效果后，接下来需要将各个分支的更改正式提交到版本控制系统中。在提交过程中，务必为每个工作树编写清晰详细的提交信息，这样不仅便于后续的版本追踪，更重要的是为即将到来的合并操作提供重要的上下文信息。 对于每个工作树，都需要执行完整的添加和提交操作。首先处理UI功能分支的提交，确保主题切换功能的所有更改都被正确记录。然后对测试功能分支进行同样的操作，将新增的测试用例和框架增强内容提交到版本库。最后完成质量控制功能分支的提交，将代码格式化工具和质量检查脚本的集成工作归档。 在实际工作中，如果经常需要执行"用描述性消息添加并提交"这类操作，完全可以将其封装成自定义命令。通过预定义的命令模板，不仅能够确保提交信息的格式一致性，还能体现公司或团队的Git最佳实践标准。 完成所有工作树的提交操作后，就可以返回主分支开始合并流程了。此时需要关闭各个工作树的终端环境，回到主要的开发环境中进行后续的集成工作。 智能合并所有工作树 在合并阶段，可以直接要求Claude Code使用 git merge 命令来处理trees文件夹中的所有工作树合并，并自动解决可能出现的冲突。这种智能化的合并方式大大简化了复杂的版本控制操作，特别是在处理多分支并行开发的场景下。 合并过程会按照工作树的创建顺序依次进行。首先合并测试功能分支，通常这个分支的合并过程相对简单，因为测试代码与其他功能模块的耦合度较低。接下来合并UI功能分支，这个过程同样比较顺利。 当处理质量功能分支的合并时，由于之前提到的pyproject.toml文件在多个工作树中都有修改，这里确实会出现合并冲突。这时就能看到Claude Code的AI能力在冲突解决方面的价值——它能够智能分析冲突的性质，理解不同更改的意图，然后提供合理的合并方案。对于一些简单的配置冲突，这种自动化处理方式比手动解决要高效得多。 在合并过程中，Claude Code会自动提交所有更改以及冲突解决方案。根据项目需要，可以选择在合并完成后删除工作树，也可以保留它们以备后续使用。系统还会进行快速验证，确保合并后的文件结构和配置信息都符合预期要求。 验证最终结果 在浏览器中测试实际效果时，我们能够看到主题切换功能已经完美实现。浅色主题和深色主题之间的切换流畅自然，用户界面的视觉效果也符合现代化的设计标准。虽然在细节优化方面可能还有一些调整空间，但核心功能已经完全达到了预期目标。更重要的是，整个开发过程展现了Git工作树技术的强大威力——通过合理的并行开发策略，我们成功避免了传统多分支开发中常见的文件冲突和版本管理难题。 通过这种方式，不仅能够高效地处理前端UI开发，还能同时推进后端测试框架的完善以及代码质量工具的集成。这种全栈式的并行开发模式极大地提升了开发效率，为复杂项目的管理提供了一种全新的解决思路。 在下一课中，我们将探索Claude Code在GitHub集成方面的更多可能性，学习如何在终端环境之外进行拉取请求审查和代码协作。 课代表学习笔记 📖 核心内容 本课重点：Git工作树并行开发。通过自定义命令标准化流程，使用工作树技术同时开发UI功能、测试增强和代码质量工具，最终智能合并完成功能集成。避免传统多窗口开发的文件冲突，大幅提升开发效率。 🎯 重点掌握 三个核心技能： 1. 自定义命令创建 ：在 .claude/commands 目录建立markdown文件，使用 $args 变量构建标准化开发流程 2. Git工作树管理 ： git worktree add 命令创建独立工作环境，确保功能模块间完全隔离 3. 智能合并策略 ：利用Claude Code的AI能力处理复杂合并冲突，高效整合多工作树更改 ⚠️ 难点解析 核心挑战：文件冲突处理 多个工作树修改同一文件（如 pyproject.toml ）时容易产生合并冲突。 解决策略： • 合理规划工作树职责边界，避免重复修改同一配置文件 • 利用Claude Code智能合并能力自动分析冲突性质 • 确保每个工作树都有详细的提交信息，便于冲突分析和团队协作 💡 实践要点 • 工作树命令： git worktree add trees/[feature name] [branch name] • 每个工作树运行独立Claude Code实例 • 善用描述性自定义命令提升开发一致性 • 定期 git worktree list 检查工作树状态 • 合并前确保完整提交记录和清晰提交信息 大家可以关注我的公众号🌟（或联系：lanyijianke1992），后台私信"cc资源包"，领取我为大家整理的课外资源💼，持续更新中✅ 我是蓝衣剑客，谢谢你看我的文章。 🔗 原文链接： https://mp.weixin.qq.com/s/2UHl9QAA... https://mp.weixin.qq.com/s/2UHl9QAA... 原创 蓝衣剑客 蓝衣剑客AI2025年09月04日 10:08 马来西亚 📌 蓝衣剑客 元神智算 CEO。WaytoAGI专栏作者。 火山引擎开发者领航KOL。清华大学数据治理研究中心 荣誉顾问。 阿里云AI训练营 讲师。 得到新商学 组局先锋/讲师。 丛书《Kimi高效办公》、《豆包高效办公》作者。 火山引擎社区、掘金AGI、LangGPT专栏作者/核心共建。拥有超过10年的软件行业经验，起草过多个AI领域国家级标准、报告。为数十家世界500强企业提供过AI领域业务咨询、项目落地指导。 一个简短的介绍，概括不了六边形的我。没事爱写点文章，谢谢你喜欢它们。 微信 公众号 📌 蓝衣剑客 元神智算 CEO。WaytoAGI专栏作者。 火山引擎开发者领航KOL。清华大学数据治理研究中心 荣誉顾问。 阿里云AI训练营 讲师。 得到新商学 组局先锋/讲师。 丛书《Kimi高效办公》、《豆包高效办公》作者。 火山引擎社区、掘金AGI、LangGPT专栏作者/核心共建。拥有超过10年的软件行业经验，起草过多个AI领域国家级标准、报告。为数十家世界500强企业提供过AI领域业务咨询、项目落地指导。 一个简短的介绍，概括不了六边形的我。没事爱写点文章，谢谢你喜欢它们。 微信 公众号 📌 蓝衣剑客 元神智算 CEO。WaytoAGI专栏作者。 火山引擎开发者领航KOL。清华大学数据治理研究中心 荣誉顾问。 阿里云AI训练营 讲师。 得到新商学 组局先锋/讲师。 丛书《Kimi高效办公》、《豆包高效办公》作者。 火山引擎社区、掘金AGI、LangGPT专栏作者/核心共建。拥有超过10年的软件行业经验，起草过多个AI领域国家级标准、报告。为数十家世界500强企业提供过AI领域业务咨询、项目落地指导。 一个简短的介绍，概括不了六边形的我。没事爱写点文章，谢谢你喜欢它们。 📌 蓝衣剑客 元神智算 CEO。WaytoAGI专栏作者。 火山引擎开发者领航KOL。清华大学数据治理研究中心 荣誉顾问。 阿里云AI训练营 讲师。 得到新商学 组局先锋/讲师。 丛书《Kimi高效办公》、《豆包高效办公》作者。 火山引擎社区、掘金AGI、LangGPT专栏作者/核心共建。拥有超过10年的软件行业经验，起草过多个AI领域国家级标准、报告。为数十家世界500强企业提供过AI领域业务咨询、项目落地指导。 一个简短的介绍，概括不了六边形的我。没事爱写点文章，谢谢你喜欢它们。 📌 蓝衣剑客 元神智算 CEO。WaytoAGI专栏作者。 火山引擎开发者领航KOL。清华大学数据治理研究中心 荣誉顾问。 阿里云AI训练营 讲师。 得到新商学 组局先锋/讲师。 丛书《Kimi高效办公》、《豆包高效办公》作者。 火山引擎社区、掘金AGI、LangGPT专栏作者/核心共建。拥有超过10年的软件行业经验，起草过多个AI领域国家级标准、报告。为数十家世界500强企业提供过AI领域业务咨询、项目落地指导。 一个简短的介绍，概括不了六边形的我。没事爱写点文章，谢谢你喜欢它们。 蓝衣剑客 元神智算 CEO。WaytoAGI专栏作者。 火山引擎开发者领航KOL。清华大学数据治理研究中心 荣誉顾问。 阿里云AI训练营 讲师。 得到新商学 组局先锋/讲师。 丛书《Kimi高效办公》、《豆包高效办公》作者。 火山引擎社区、掘金AGI、LangGPT专栏作者/核心共建。拥有超过10年的软件行业经验，起草过多个AI领域国家级标准、报告。为数十家世界500强企业提供过AI领域业务咨询、项目落地指导。 一个简短的介绍，概括不了六边形的我。没事爱写点文章，谢谢你喜欢它们。 微信 公众号 微信 微信 公众号 公众号 本课概览 在现代软件开发中，多功能并行开发已成为提升开发效率的关键策略。本节课将深入探讨如何在Claude Code环境中实现真正意义上的并行开发，避免传统多窗口开发可能带来的文件覆盖问题。 我们首先学习如何创建自定义命令来标准化开发流程，这不仅能够提升开发效率，还能确保团队协作的一致性。接下来，课程的核心内容是Git工作树（worktree）技术的深度应用。通过实际演示，你将掌握如何同时在三个不同的功能分支上进行开发：UI主题切换功能、测试框架增强，以及代码质量工具集成。 学完本节课后，你将具备独立管理复杂并行开发项目的能力，能够熟练运用Git工作树避免开发冲突，并且掌握如何使用Claude Code智能化地处理合并冲突。这种技能对于大型项目开发和团队协作具有极其重要的价值。本课内容承接前面的基础操作，为后续的GitHub集成和更高级的工作流奠定了坚实基础。 在现代软件开发中，多功能并行开发已成为提升开发效率的关键策略。本节课将深入探讨如何在Claude Code环境中实现真正意义上的并行开发，避免传统多窗口开发可能带来的文件覆盖问题。 我们首先学习如何创建自定义命令来标准化开发流程，这不仅能够提升开发效率，还能确保团队协作的一致性。接下来，课程的核心内容是Git工作树（worktree）技术的深度应用。通过实际演示，你将掌握如何同时在三个不同的功能分支上进行开发：UI主题切换功能、测试框架增强，以及代码质量工具集成。 学完本节课后，你将具备独立管理复杂并行开发项目的能力，能够熟练运用Git工作树避免开发冲突，并且掌握如何使用Claude Code智能化地处理合并冲突。这种技能对于大型项目开发和团队协作具有极其重要的价值。本课内容承接前面的基础操作，为后续的GitHub集成和更高级的工作流奠定了坚实基础。 大家可以关注我的公众号🌟（或联系：lanyijianke1992），后台私信"cc资源包"，领取我为大家整理的课外资源💼，持续更新中✅ 并行开发：使用Git工作树管理多个功能 在Claude Code环境中实现并行开发时，我们需要运用Git工作树技术来有效管理多个功能的同时开发。这种方法能够确保不同功能的开发过程相互独立，避免文件覆盖问题，同时还能提升整体开发效率。 创建自定义命令 在深入探讨工作树技术之前，我们先来了解Claude Code的自定义命令功能。虽然系统内置了丰富的命令集，但创建自定义命令能够让我们根据具体项目需求定制开发流程。通过在Claude文件夹内创建名为"commands"的新文件夹，然后在其中建立以命令名称命名的markdown文件，就能实现自定义命令的配置。 以创建"implement feature"命令为例，我们需要新建一个名为ImplementFeature.md的markdown文件。这个文件的特殊之处在于可以使用美元符号参数变量来接收传递的参数。在命令执行时，系统会根据用户指定的功能需求来生成相应的实现方案，并且能够精确控制操作范围，比如限定只处理前端功能，同时将所有更改记录到指定的文档中。 自定义命令的应用场景非常广泛，无论是测试执行、文件处理还是特定的开发工作流，都能通过这种方式实现标准化管理。需要注意的是，自定义命令中的内容不会自动添加到上下文中，这与claude.md文件的全局应用特性不同。因此，对于需要在所有Claude Code实例中应用的配置，应当使用claude.md文件；而对于特定场景下使用的命令，自定义命令则是理想的选择。 完成自定义命令的创建后，重新启动Claude Code就能在命令列表中看到新添加的"implement feature"选项，其描述信息会自动提取自markdown文件的开头部分。 提交自定义命令到版本控制 完成自定义命令的创建工作后，接下来需要将这些配置文件正式纳入版本控制系统。虽然可以通过命令行手动完成这一操作，但更高效的方式是直接让Claude Code来处理这个提交过程。这样不仅能够节省时间，还能确保生成描述清晰的提交信息，准确记录本次更改的具体内容。 在执行提交操作时，系统会自动将.claude文件夹及其相关配置文件添加到版本库中。由于之前已经为这类操作授予了相应权限，整个过程无需额外的确认步骤。这些权限配置信息存储在Claude文件夹内的settings.local.json文件中，通过预先设定允许的命令类型，可以避免重复的权限确认提示。值得注意的是，类似Playwright等工具的权限配置也会保存在此文件中，用户可以根据需要直接编辑该文件，或者使用便捷的permissions命令来管理权限设置。 在自定义命令配置完成后，我们需要深入了解Claude Code的并行工作机制。传统的多窗口开发方式虽然看似直观，但在处理同一代码库时容易产生文件覆盖问题，这会导致代码冲突、功能缺失甚至系统错误。为了彻底解决这一问题，我们需要借助Git工作树技术来构建真正意义上的并行开发环境。 Git工作树功能为并行开发提供了理想的解决方案。通过创建代码库的独立副本，每个开发分支都能在完全隔离的环境中进行，避免了不同功能开发过程中的相互干扰。当各个功能模块开发完成后，再通过智能化的合并机制将所有更改整合到主分支中。在这个过程中，Claude的AI能力能够有效协助处理合并冲突和工作树管理任务，大大简化了复杂的版本控制操作。 创建和配置工作树环境 实际操作Git工作树时，首先需要创建一个名为"trees"的文件夹作为工作树的统一管理目录。随后通过 git worktree add 命令创建具体的工作树实例，每个工作树都对应特定的功能分支。在本次演示中，我们将创建三个独立的工作树：分别命名为"ui feature"、"testing feature"和"quality feature"，用于并行开发不同的功能模块。 通过 git worktree list 命令可以确认所有工作树的创建状态，此时能够看到主分支的当前位置以及三个新建的独立工作树分支。为了便于管理和操作，需要为每个工作树分别打开独立的终端窗口。首先打开trees文件夹，然后为UI功能、测试功能和质量控制功能分别创建专用的终端环境，合理安排窗口布局以确保操作的便利性。 在工作环境准备就绪后，就可以在每个独立的工作树中启动Claude Code实例了。这种并行运行机制的优势在于，即使不同的工作树修改了相同的文件，也不会产生直接的冲突覆盖问题，所有潜在的合并冲突都会在最终的工作树合并阶段统一处理。 并行开发三个功能模块 在第一个工作树中，我们将使用之前创建的 /implement feature 自定义命令来开发主题切换功能。这个功能需要实现深色和浅色主题之间的动态切换，包括切换按钮的创建、位置布局以及相应的导航逻辑。开发过程将分为两个阶段：首先实现基础的切换功能框架，然后添加具体的浅色主题样式变体。 同时，在第二个工作树中，我们专注于测试框架的增强工作。通过发送相应的提示指令，让Claude Code为现有的测试框架添加更多的测试用例，特别是针对FastAPI端点的专项测试，以提升整个系统的测试覆盖率和可靠性。 第三个工作树的任务是集成代码质量工具，为开发工作流程添加必要的代码分析和格式化功能。当这些不同的功能开发同时进行时，我们可以在各个环境之间灵活切换，实时查看开发进度并确认所需的功能更改。 随着三个工作树中的开发工作逐步推进，我们能够观察到各个功能模块的实现进展。测试框架的增强工作正在有序进行，同时代码质量工具的集成也在同步添加相应的开发依赖项，这些依赖项主要用于代码库结构分析和格式化处理。值得注意的是，在这个过程中多个工作树都需要修改pyproject.toml配置文件，这正好体现了工作树技术在处理文件冲突方面的价值。 在并行开发的过程中，各个工作树之间保持着良好的独立性。前端主题切换功能的开发进展顺利，测试用例的添加工作也在按计划执行，同时代码格式化工具和质量检查脚本的集成也在稳步推进。这种并行工作模式确保了不同功能模块的开发互不干扰，即使某些文件被多个工作树同时修改，也不会产生立即的冲突覆盖问题。 当前端功能的基础框架完成后，接下来需要添加浅色主题的具体实现。继续使用 /implement feature 自定义命令来管理这一开发流程，确保所有更改都能被正确记录到变更日志中。在主题功能开发的同时，还需要完善相关的JavaScript交互逻辑和具体的实现细节。 在质量控制工作树中，一些新的开发脚本可能需要额外的依赖项支持。当遇到Claude Code不熟悉的脚本时，系统会自动尝试安装必要的依赖项，或者根据实际情况调整执行策略。通过这种方式，我们能够看到代码质量检查工具的启动过程，API端点测试的编写进展，以及前端功能的持续完善。