Swift 开发 Git 项目管理：核心技巧+详细案例

Swift 开发 Git 项目管理：核心技巧+

详细案例

Swift 项目的 Git 管理核心是「规范分支流程+精简提交信息+避坑操作」，以下结合 Xcode 开发实战，从「分支策略、提交规范、协作流程、常见问题」四大模块，附可直接落地的代码和操作步骤。

一、核心分支策略（Git Flow 简化版，适配 iOS 项目）

Swift 项目（尤其是 App Store 上架项目）需严格区分「开发、测试、发布」流程，推荐 简化版 Git Flow，避免分支混乱：

1. 固定分支（长期存在）

• main：生产环境分支，仅存储上架版本代码，禁止直接提交，仅通过合并更新；

• develop：开发主分支，存储稳定的开发代码，所有功能开发完成后合并至此。

2. 临时分支（功能完成后删除）

• feature/xxx：功能分支（如 feature/login-module、feature/live-danmaku），从 develop 分支创建；

• bugfix/xxx：bug 修复分支（如 bugfix/login-crash），从 develop 分支创建；

• hotfix/xxx：紧急修复分支（如 hotfix/app-crash-ios16），从 main 分支创建，修复后同步合并到 main 和 develop。

3. 分支操作案例（命令行+Xcode 操作）

（1）命令行操作（推荐，灵活高效）

# 1. 克隆远程仓库（首次拉取项目）

git clone https://github.com/your-username/your-swift-project.git

cd your-swift-project

# 2. 从 develop 创建功能分支（开发新功能）

git checkout develop

git pull origin develop # 拉取最新代码

git checkout -b feature/login-module # 创建并切换到功能分支

# 3. 开发完成后，提交代码到功能分支

git add . # 添加所有修改文件（或指定文件：git add ViewController.swift）

git commit -m "feat(登录模块): 实现用户名密码登录+验证码登录"

git push origin feature/login-module # 推送到远程仓库

# 4. 从 develop 创建 bugfix 分支（修复开发环境 bug）

git checkout develop

git pull origin develop

git checkout -b bugfix/login-crash

# 5. 紧急修复生产环境 bug（hotfix 分支）

git checkout main

git pull origin main

git checkout -b hotfix/app-crash-ios16

# 修复后提交

git add .

git commit -m "fix(紧急修复): 解决 iOS16 启动崩溃问题"

git push origin hotfix/app-crash-ios16

（2）Xcode 可视化操作（适合不熟悉命令行的开发者）

1. 克隆仓库：Xcode → Check out an existing project → 输入仓库 URL → 选择存储路径；

2. 切换分支：Xcode 顶部导航栏 → Source Control → Checkout → 选择目标分支（如 develop）；

3. 创建分支：Source Control → New Branch → 输入分支名（如 feature/login-module）→ 选择基于 develop 分支 → Create；

4. 提交代码：Source Control → Commit → 勾选要提交的文件 → 输入提交信息 → Commit；

5. 推送分支：Source Control → Push → 选择远程仓库 → Push。

二、提交规范（Swift 项目统一风格，便于回溯）

提交信息需遵循「类型(模块): 描述」格式，清晰说明修改目的，推荐规范如下：

1. 提交类型（必填）

• feat：新功能（如 feat(直播): 实现弹幕发送功能）；

• fix：修复 bug（如 fix(登录): 解决密码输入长度限制bug）；

• refactor：代码重构（无功能变更，如 refactor(首页): 优化 tableView 数据源逻辑）；

• style：代码格式调整（无逻辑变更，如 style: 格式化代码缩进）；

• docs：文档更新（如 docs: 更新 README 中的集成步骤）；

• test：添加测试用例（如 test(登录): 新增登录功能单元测试）；

• chore：构建/依赖调整（如 chore: 更新 CocoaPods 依赖版本）。

2. 提交信息案例（正面+反面）

规范案例（推荐） 不规范案例（避免） 问题所在

feat(直播): 实现连麦申请功能 添加连麦功能 无类型和模块，不清晰

fix(列表): 修复下拉刷新数据重复问题 修复 bug 无模块和具体描述

refactor(网络): 重构 APIManager 代码结构 重构代码 无模块，目的不明确

chore: 升级 SnapKit 到 5.6.0 更新依赖 无具体依赖和版本

3. 批量修改提交（合并多个小提交）

开发中可能产生多个临时提交，推送前可合并为一个清晰的提交：

# 合并最近 3 个提交（根据实际数量调整）

git rebase -i HEAD~3

执行后进入编辑模式，将需要合并的提交前的 pick 改为 squash（或 s），保存后输入合并后的提交信息。

三、协作开发流程（多人协作 Swift 项目实战）

以「2 人协作开发登录模块+首页模块」为例，完整流程如下：

1. 前期准备（管理员操作）

1. 远程仓库创建 main 和 develop 分支（默认分支设为 develop）；

2. 开启分支保护：禁止直接向 main 和 develop 提交代码，仅允许通过 Pull Request（PR）合并。

2. 开发者 A：开发登录模块

# 1. 拉取仓库并切换到 develop 分支

git clone https://github.com/your-username/your-swift-project.git

cd your-swift-project

git checkout develop

git pull origin develop

# 2. 创建功能分支

git checkout -b feature/login-module

# 3. 开发过程中，定期拉取 develop 分支的最新代码（避免冲突）

git pull origin develop

# 4. 开发完成，提交并推送分支

git add .

git commit -m "feat(登录): 实现用户名密码登录+验证码登录+忘记密码"

git push origin feature/login-module

# 5. 提交 PR（GitHub/GitLab 操作）

# - 登录 GitHub → 仓库 → Pull requests → New pull request

# - 选择 base: develop，compare: feature/login-module

# - 填写 PR 描述（功能说明、测试情况）→ Create pull request

3. 开发者 B：开发首页模块

# 1. 拉取仓库并创建功能分支

git clone https://github.com/your-username/your-swift-project.git

cd your-swift-project

git checkout develop

git pull origin develop

git checkout -b feature/home-page

# 2. 开发并提交代码

git add .

git commit -m "feat(首页): 实现轮播图+直播列表+推荐内容"

git push origin feature/home-page

# 3. 提交 PR 到 develop 分支

4. 代码审核与合并（管理员/技术负责人）

1. 查看 PR 中的代码变更，提出修改意见（如代码规范、逻辑问题）；

2. 开发者根据意见修改后，再次提交到该分支（PR 会自动更新）；

3. 审核通过后，合并 PR 到 develop 分支，并删除远程功能分支；

4. 合并后，通知所有开发者拉取 develop 分支最新代码：

git checkout develop

git pull origin develop

5. 发布版本（管理员操作）

# 1. 从 develop 分支创建发布分支（可选，复杂项目使用）

git checkout develop

git pull origin develop

git checkout -b release/1.0.0

# 2. 发布前测试，修复小 bug（直接提交到 release 分支）

git add .

git commit -m "fix: 修复发布前发现的 UI 错位问题"

git push origin release/1.0.0

# 3. 测试通过后，合并到 main 和 develop 分支

git checkout main

git pull origin main

git merge --no-ff release/1.0.0 -m "chore: 发布 1.0.0 版本"

git push origin main

git checkout develop

git pull origin develop

git merge --no-ff release/1.0.0 -m "chore: 合并 release/1.0.0 到 develop"

git push origin develop

# 4. 打标签（标记版本，便于回溯）

git tag -a 1.0.0 -m "Version 1.0.0（首次上架）"

git push origin 1.0.0

四、Swift 项目 Git 避坑技巧（高频问题解决）

1. 忽略不需要提交的文件（.gitignore 配置）

Swift 项目需忽略 Xcode 生成的临时文件、Pods 依赖等，创建 .gitignore 文件放在项目根目录：

# Xcode 相关

DerivedData/

*.xcuserstate

*.xcworkspace

!default.xcworkspace

*.xcuserdatad

*.xccheckout

*.xcsettings

*.xcodeproj/xcuserdata/

# CocoaPods

Pods/

Podfile.lock

!Podfile

!Podfile.swift

# Carthage

Carthage/

.build/

# 其他

.DS_Store

*.log

*.tmp

• 注意：如果已将不需要的文件提交到仓库，需先删除远程文件再添加到 .gitignore：

git rm --cached Pods/ # 移除远程 Pods 目录（本地保留）

git add .gitignore

git commit -m "chore: 添加 .gitignore 忽略临时文件"

git push origin develop

2. 解决代码冲突（Swift 项目常见场景）

冲突多发生在多人修改同一文件（如 AppDelegate.swift、Info.plist），解决步骤：

# 1. 拉取远程分支最新代码，触发冲突

git pull origin develop

# 2. 查看冲突文件（终端会提示 conflicted files）

# 或用 Xcode 查看：Source Control → Resolve Conflicts → 选择冲突文件

# 3. 手动解决冲突（打开冲突文件，编辑冲突部分）

# 冲突标记：

# <<<<<<< HEAD（当前分支代码）

# let baseURL = "https://api.old.com"

# =======

# let baseURL = "https://api.new.com"

# >>>>>>> origin/develop（远程分支代码）

# 4. 解决后提交

git add 冲突文件名.swift

git commit -m "merge: 解决与 develop 分支的 baseURL 冲突"

git push origin 你的分支名

3. 撤销本地修改（未提交前）

# 撤销单个文件的本地修改（恢复到最近一次提交状态）

git checkout -- ViewController.swift

# 撤销所有本地未提交的修改（谨慎使用）

git checkout .

# 撤销已 add 的文件（取消暂存）

git reset HEAD ViewController.swift

4. 回滚已提交的代码（已推送至远程）

# 1. 查看提交记录，找到要回滚的 commit ID（前 7 位即可）

git log --oneline

# 输出示例：a1b2c3d (HEAD -> develop) feat: 新增某功能

# 2. 创建回滚分支（避免直接修改主分支）

git checkout -b revert-feature-a1b2c3d

# 3. 回滚到目标 commit（保留回滚记录，推荐）

git revert a1b2c3d -m 1

# 注：-m 1 表示保留当前分支的代码，丢弃要回滚的 commit 变更

# 4. 提交并推送回滚分支，提交 PR 合并到 develop

git push origin revert-feature-a1b2c3d

5. 关联 Xcode 与 Git 仓库（避免每次输入账号密码）

# 1. 配置全局用户名和邮箱（首次使用 Git 时配置）

git config --global user.name "你的名字"

git config --global user.email "你的邮箱"

# 2. 配置 SSH 密钥（免密码登录，推荐）

# 生成 SSH 密钥（终端执行，一路回车）

ssh-keygen -t rsa -C "你的邮箱"

# 复制密钥（macOS）

pbcopy < ~/.ssh/id_rsa.pub

# 粘贴到 GitHub → Settings → SSH and GPG keys → New SSH key

# 测试连接

ssh -T git@github.com

# 成功提示：Hi your-username! You've successfully authenticated...

# 3. 后续克隆仓库用 SSH 地址（而非 HTTPS）

git clone git@github.com:your-username/your-swift-project.git

五、总结

Swift 项目的 Git 管理核心是「规范+协作」：

1. 分支严格遵循「main→develop→临时分支」流程，避免混乱；

2. 提交信息清晰规范，便于后续回溯和维护；

3. 多人协作时，定期拉取主分支代码，提前解决冲突；

4. 善用 .gitignore 和 SSH 密钥，提升开发效率。