Xcode 的 project.pbxproj 檔案採用文字格式儲存專案結構，但 Xcode 在新增檔案或修改設定時，不保證項目的插入順序一致。多人協作時，即使修改不同的檔案或 target，也可能因為項目順序差異而產生 merge conflict。這些衝突往往與實際變更無關，純粹是格式問題。

我的解決方案

將 project.pbxproj 中的各個區塊按固定規則排序，確保相同內容產生相同的檔案結構。配合 git pre-commit hook，每次提交前自動排序，團隊成員的專案檔就能維持一致的順序，大幅降低無意義的衝突。

我開發了一個腳本工具來執行這個任務，也已經在多個專案上跑了好幾年，GitHub repo 放在這裡：https://github.com/chiahsien/sort-Xcode-project-file

雖然目前推崇使用 Swift Package Manager 進行模組化，Xcode 16 也引入了 buildable folders 功能來減少專案檔變更，甚至也有 Tuist 或 Xcode Gen 這類的工具來生成專案檔，但這些新技術主要針對新專案或願意大幅重構的專案。對於已經開發多年、結構複雜的舊專案，貿然改用 SPM 模組化或轉換成 folder references 風險過高。此時，這個排序工具仍是最務實的選擇，能以最小成本解決 merge conflict 問題。

在專案開發到一定規模後，你可能會發現某些 feature 其實相對獨立：它們有自己的流程、畫面、資源檔，甚至可以被其他專案重用。這時候，最乾淨、最有彈性的做法，就是把它抽成 Swift Package。

以我最近在做的功能為例，它是一個完整的獨立模組 - 有多個頁面、支援多國語言、使用圖片與動畫資源。為了避免日後整合時出現命名衝突、相依過重或編譯過慢的問題，我選擇把它獨立成一個 Swift Package。在將 feature 抽出到 Package 的過程我也踩到了一些坑，趁著這個機會記錄下來，以免日後忘記。

為什麼要把 Feature 打包成 Swift Package？

建立專屬的 Swift Package 有幾個明顯的好處：

• ✅ 可獨立開發與測試：模組化後不必依賴主專案，可單獨編譯與驗證。
• ⚙️ 降低相依與衝突：減少命名重複、依賴鏈過長等問題。
• 🚀 加快編譯速度：主專案不需每次都重新編譯整個功能。
• 🔄 方便整合與重用：未來可以直接被其他 app 或團隊使用。

工程師都會有自己習慣的電腦設定，我自然也不例外。本文記錄了我自己的環境建置，方便以後換電腦或換工作時可以快速 setup。

在網路上已經有很多關於 iOS Share Extension 的教學，例如這裡就有一篇。有需要的人可以自行在網路上搜尋，這邊就不多作著墨。我這次想要分享的主要是在開發 share extension 的過程遇到一些要注意的事項，以及踩到的一些坑。

我的開發環境是 macOS Sonoma + Xcode 15，使用 Swift 開發。

要建立一個 share extension 很簡單，就是在你的專案新增一個 target 然後選擇 Share Extension 即可。Xcode 會自動幫忙產生必要的檔案，以及做好基本設定。

Visual Studio Code 是我預設的文字編輯器，它跨平台、執行速度快、開啟大檔案沒問題、擴充套件眾多，是我選擇用它的主要原因。底下列出一些對我幫助很大的擴充套件：

下載

不要透過 AppStore，因為速度太慢太不穩定了，要去官方網站下載才快。但是我們還有更快的方法，可以透過下載軟體同時開啟多條連線下載，我推薦使用 XcodesApp 或 Downloader-for-Apple-Developers，前者比較漂亮，後者還可以下載 WWDC 的影片。

安裝

不要直接解壓縮 xip 檔，這樣會花很長的時間。下指令去解會快很多：

xip -x Xcode.xip

管理

可以放多個不同版本的 Xcode 在 Applications 資料夾，只要名稱不一樣就好了，記得要下指令來指定要使用哪個版本。

sudo xcode-select -s /Applications/Xcode.app

時間久了之後，會產生很多沒再用的檔案佔用空間，我們可以使用 DevCleaner for Xcode 或 XcodeCleaner-SwiftUI 來幫忙清理，效果非常的好！

參考資料

安裝 Xcode 的正確姿勢