# 編輯 {#editing}

與傳統的 Xcode 專案或 Swift Packages 不同（後者透過 Xcode 的 UI 進行變更），由 Tuist 管理的專案是定義在包含於 **資訊清單檔案** 中的 Swift 程式碼。如果你熟悉 Swift Packages 和 `Package.swift` 檔案，這種做法非常類似。

你可以使用任何文字編輯器來編輯這些檔案，但我們建議使用 Tuist 提供的工作流程：`tuist edit`。此工作流程會建立一個包含所有資訊清單檔案的 Xcode 專案，並讓你能夠編輯和編譯它們。藉助 Xcode，你可以獲得 **程式碼自動補全、語法突顯和錯誤檢查** 等所有優勢。

## 編輯專案 {#edit-the-project}

若要編輯你的專案，你可以在 Tuist 專案目錄或子目錄中執行以下指令：

```bash
tuist edit
```

該指令會在全域目錄中建立一個 Xcode 專案並在 Xcode 中開啟它。該專案包含一個 `Manifests` 目錄，你可以建置它以確保所有資訊清單都有效。

> [!NOTE]
> **透過 Glob 解析的資訊清單**
>
> `tuist edit` 會使用從專案根目錄（即包含 `Tuist.swift` 檔案的目錄）出發的 glob `**/{Manifest}.swift` 來解析要納入的資訊清單。請確保專案根目錄下有一個有效的 `Tuist.swift`。


### 忽略資訊清單檔案 {#ignoring-manifest-files}

如果你的專案在非實際 Tuist 資訊清單的子目錄中包含與資訊清單檔案同名的 Swift 檔案（例如 `Project.swift`），你可以在專案根目錄建立一個 `.tuistignore` 檔案，將它們從編輯專案中排除。

`.tuistignore` 檔案使用 glob 模式來指定應忽略哪些檔案：

```gitignore
# Ignore all Project.swift files in the Sources directory
Sources/**/Project.swift

# Ignore specific subdirectories
Tests/Fixtures/**/Workspace.swift
```

當你擁有恰好使用與 Tuist 資訊清單檔案相同命名慣例的測試固定資料或範例程式碼時，這特別有用。

## 編輯與產生工作流程 {#edit-and-generate-workflow}

你可能已經注意到，無法從產生的 Xcode 專案進行編輯。這是刻意設計，以防止產生的專案對 Tuist 產生依賴關係，確保你未來可以輕鬆地從 Tuist 遷移。

在迭代開發專案時，我們建議從一個終端機工作階段執行 `tuist edit` 以取得用於編輯專案的 Xcode 專案，並使用另一個終端機工作階段執行 `tuist generate`。