分支部署策略

定義

透過 Git 分支來對應不同部署環境的策略。典型模式：dev 分支對應預覽/測試環境，main 分支對應正式環境。推送到特定分支會自動觸發對應環境的建置與部署。

關鍵數據點（附來源）

• Cloudflare Pages 支援自訂預覽分支，dev 分支推送後自動部署到 dev.codotx.pages.dev。（cloudflare-pages-preview-access）
• 三條部署鐵律：先推 dev 再上 main、認明預覽環境後綴、記得收驗證信。（cloudflare-pages-branch-strategy）
• 推錯分支（直接推 main）會導致預覽環境完全無反應，需 cherry-pick 回 dev。（cloudflare-pages-branch-strategy）
• GitHub Actions 可監聽特定分支的 push 事件執行自動化任務。（github-actions-notion-commit-log）

前提與局限性

• 所有團隊成員必須理解並遵守分支策略。
• 不適用於 trunk-based development。
• 緊急修復（hotfix）時可能需要例外機制。
• 單人開發者可能覺得多分支是不必要的開銷。

衝突標記

（無）

關聯概念

• [[預覽環境存取控制]]
• [[Cloudflare Pages]]
• [[GitHub Actions]]
• [[部署流程規範]]