Git 指令大多在終端機下執行,效能與彈性都最好,缺點是需要記住指令。因此不少開發者偏好圖形介面,而 Xcode 作為整合開發環境也內建了一定程度的 Git 圖形功能——但使用前必須先做好設定,否則版本庫會被一堆不該追蹤的檔案塞滿。
用 Xcode 4 建立的 iOS 專案,在終端機提交時常看到類似下面的訊息:
create mode 100644 HelloWorld.xcodeproj/project.xcworkspace/contents.xcworkspacedata
create mode 100644 HelloWorld.xcodeproj/project.xcworkspace/xcuserdata/tonyguan.xcuserdatad/UserInterfaceState.xcuserstate
create mode 100644 HelloWorld.xcodeproj/xcuserdata/tonyguan.xcuserdatad/xcschemes/HelloWorld.xcscheme
create mode 100644 HelloWorld.xcodeproj/xcuserdata/tonyguan.xcuserdatad/xcschemes/xcschememanagement.plist
rewrite HelloWorld.xcodeproj/project.xcworkspace/xcuserdata/tonyguan.xcuserdatad/UserInterfaceState.xcuserstate (83%)
這些檔案絕大部分不該進入版本控制。原則很簡單:能列入版本控制的只有原始碼與專案設定,二進位產物、臨時檔、使用者專屬設定都不該追蹤。
HelloWorld
├── HelloWorld
│ ├── AppDelegate.h / AppDelegate.m
│ ├── ViewController.h / ViewController.m
│ ├── HelloWorld-Info.plist
│ ├── HelloWorld-Prefix.pch
│ ├── main.m
│ └── en.lproj
│ ├── InfoPlist.strings
│ └── ViewController.xib
└── HelloWorld.xcodeproj
├── project.pbxproj ← 必須追蹤
├── project.xcworkspace ← 不該追蹤
│ ├── contents.xcworkspacedata
│ └── xcuserdata/…/UserInterfaceState.xcuserstate
└── xcuserdata/… ← 不該追蹤
├── xcdebugger/Breakpoints.xcbkptlist
└── xcschemes/
HelloWorld.xcodeproj 其實是一個套件(package)。其中 project.pbxproj 記錄了專案結構與編譯設定,是團隊共享的關鍵檔案,必須提交;但 project.xcworkspace 與 xcuserdata 屬於「使用者專屬」,記錄的是某台機器上某個人的視窗佈局、中斷點與 scheme 偏好,對其他人毫無意義,只會製造無謂的衝突。
# 排除編譯輸出目錄
build/*
# 排除臨時 nib 與 swap 檔
*~.nib
*.swp
# 排除 OS X 的資料夾屬性檔
.DS_Store
# 排除 Xcode 3 與 4 的使用者專屬檔案
*.mode1
*.mode1v3
*.mode2v3
*.perspective
*.perspectivev3
*.pbxuser
*.xcworkspace
xcuserdata
檔案中的 # 是註解,其餘每行是一條規則,支援 glob 樣式。上面這份設定同時考慮了 Xcode 3 與 4 的差異,所以兩代的雜項都涵蓋了。
只對單一專案生效:把 .gitignore 放在程式碼庫(repository)根目錄,也就是與 .git 資料夾同層的位置。
<程式碼庫目錄>/
├── .git/
├── .gitignore ← 放在這裡
└── HelloWorld/
├── HelloWorld/
└── HelloWorld.xcodeproj/
對所有 Xcode 專案生效:用 git config 設定全域忽略檔。
git config --global core.excludesfile ~/.gitignore
這條指令會把設定寫入 ~/.gitconfig。--global 表示套用於目前使用者的所有專案,~/.gitignore 則指定忽略規則檔放在使用者家目錄下。
如果檔案已經被追蹤了,單純加進 .gitignore 並不會生效——Git 只對「尚未追蹤」的檔案套用忽略規則。此時要先把檔案從索引中移除:
git rm -r --cached HelloWorld.xcodeproj/xcuserdata
--cached 參數的意義是只從 Git 索引移除、保留本機實體檔案,避免誤刪自己的設定。
.gitignore 本身應該要提交進版本庫,這樣所有成員 clone 下來就自動套用同一套規則。另外提醒,忽略規則只影響 Git 的追蹤行為,它並不是安全機制——想排除的是「機密檔案」的話,那些檔案一旦進過歷史紀錄就已經洩漏了,必須改用 filter-branch 或 BFG 重寫歷史。