编辑

编辑 {#editing}

与传统的 Xcode 项目或 Swift 包不同（更改是通过 Xcode 的 UI 进行的），Tuist 管理的项目定义在包含在清单文件中的 Swift 代码中。如果你熟悉 Swift 包和 Package.swift 文件，方法非常相似。

你可以使用任何文本编辑器来编辑这些文件，但我们推荐使用 Tuist 为此提供的工作流，即 tuist edit。该工作流会创建一个包含所有清单文件的 Xcode 项目，允许你编辑和编译它们。通过使用 Xcode，你可以获得代码补全、语法高亮和错误检查的所有好处。

编辑项目 {#edit-the-project}

要编辑项目，你可以在 Tuist 项目目录或子目录中运行以下命令：

tuist edit

该命令会在全局目录中创建一个 Xcode 项目并在 Xcode 中打开它。该项目包含一个 Manifests 目录，你可以构建它来确保所有清单文件都有效。

::: info GLOB 解析的清单文件

tuist edit 通过使用项目根目录（包含 Tuist.swift 文件的目录）中的 glob **/{Manifest}.swift 来解析要包含的清单文件。确保在项目根目录有一个有效的 Tuist.swift。

:::

忽略清单文件 {#ignoring-manifest-files}

如果你的项目包含与清单文件同名的 Swift 文件（例如 Project.swift），但它们位于不是实际 Tuist 清单的子目录中，你可以在项目根目录创建 .tuistignore 文件来将它们从编辑项目中排除。

.tuistignore 文件使用 glob 模式来指定应忽略哪些文件：

# 忽略 Sources 目录中的所有 Project.swift 文件
Sources/**/Project.swift

# 忽略特定的子目录
Tests/Fixtures/**/Workspace.swift

当你有测试 fixtures 或示例代码恰好使用与 Tuist 清单文件相同的命名约定时，这特别有用。

编辑和生成工作流 {#edit-and-generate-workflow}

你可能已经注意到，编辑不能在生成的 Xcode 项目中进行。这是设计如此，以防止生成的项目依赖 Tuist，确保你以后可以轻松地从 Tuist 迁移。

在迭代项目时，我们建议从一个终端会话运行 tuist edit 来获取一个用于编辑项目的 Xcode 项目，然后使用另一个终端会话运行 tuist generate。