メインコンテンツへスキップ
  1. ノート/
  2. Git/

Git バージョン管理

·2275 文字·5 分· loading · loading · · ·
ICE345
著者
ICE345
CS Student | System | Linux | OCaml

複数人で協作する時、Git を使ったバージョン管理はコンフリクトを効果的に回避・解決できます。それでも、バージョンコンフリクトに遭遇することはあります。主な原因は、複数の開発者が同じファイルの同じ部分を変更し、Git が自動的にそれらを統合できないことです。以下では、Git のバージョンコンフリクトが発生する場面、解決方法、そして複数人協作でのバージョン管理について説明します。

一、Git バージョンコンフリクトが発生する場面
#

  1. 同じファイルの同じ部分を複数の開発者が変更した場合: 複数の開発者が同じファイルの同じ部分を変更すると、それらをマージしようとした時、Git はどちらの変更を残すべきか自動判断できません。例:

    • 開発者 A が file.txt の10行目を変更し、コミットして push した。
    • 開発者 B も、開発者 A が push する前に file.txt の10行目を変更し、その後 push しようとした。
  2. 異なるブランチのマージ: 異なるブランチ上のコードは通常、異なる開発進捗を持っています。ある開発者が二つの異なるブランチで同じファイルの同じ部分を変更した場合、ブランチをマージする時にコンフリクトが発生します。

  3. 手動コンフリクト解決の失敗: コンフリクト発生時、開発者が手動で解決する際に必要なコードを正しく残さなかった場合、リモートリポジトリへ push する時に再びコンフリクトが起きることがあります。

二、Git バージョンコンフリクトの解決方法
#

コンフリクトが発生すると、Git は衝突箇所をマークします。ファイル内容は次のような形式になります。

<<<<<<< HEAD
# 現在のブランチのコード
=======
# 他のブランチのコード
>>>>>>>

この場合、どちらのコードを残すか、または二つのバージョンをどう統合するかを手動で決める必要があります。具体的な手順は以下の通りです。

1. コンフリクトファイルを確認する
#

コードをマージしようとした時、コンフリクトがあるとコミットが止まり、衝突ファイルが表示されます。以下のコマンドで確認できます。

git status

コンフリクトファイルは “Unmerged paths” の下に表示されます。

2. 手動でコンフリクトを解決する
#

衝突ファイルを開き、<<<<<<<=======>>>>>>> のマーカーを見ながら手動で解決します。片方のコードを残すことも、異なる部分を統合することもできます。解決後、衝突マーカーを削除して保存します。

3. コンフリクト解決済みとしてマークする
#

解決後、git addコマンドで Git にコンフリクトが解決済みであることを伝えます。

git add <conflict-file>

4. マージ結果をコミットする
#

最後に、コンフリクト解決後の変更をコミットします。

git commit -m "Resolve merge conflict"

5. リモートリポジトリへ push する
#

コンフリクト解決後、マージ後のコードをリモートリポジトリへ push できます。

git push origin <branch-name>

三、複数人協作における Git バージョン管理の実践
#

コンフリクトを避け、減らすために、チームで協作する時はいくつかのベストプラクティスに従うべきです。以下は詳細なバージョン管理フローと戦略です。

1. ブランチ戦略を使う
#

  • メインブランチ(main または master:安定し、リリース済みのコードを置く。
  • 開発ブランチ(develop:開発用の主ブランチ。すべての開発者のコードを統合する。
  • 機能ブランチ(feature/xxx:機能や修正ごとに独立したブランチを作り、開発中に他機能へ影響しないようにする。

開発者は機能ブランチで作業し、機能開発が完了したらdevelopへマージし、最後にdevelopmainへマージします。

2. 定期的にコードを pull する(git pull
#

開発者は作業前とコード提出前に、リモートリポジトリから最新コードを定期的に pull し、自分のコードが最新状態を基にしていることを確認します。

git pull origin <branch-name>

3. 頻繁かつ小規模な変更をコミットする
#

大規模なコミットほどコンフリクトが起こりやすいため、頻繁で小さい変更をコミットするとコンフリクト発生を減らせます。以下のコマンドでコミットできます。

git add .
git commit -m "Describe the changes made"
git push origin <branch-name>

4. コードレビュー(Code Review)と Pull Request
#

  • 複数人協作では、開発者は Pull Request を作成してコードをマージするべきです。Pull Request により、他のチームメンバーがコードをレビューし、品質を確保しつつコンフリクトを減らせます。
  • Pull Request は通常、feature/xxxブランチとdevelopブランチの間で行い、レビュー通過後にマージします。

5. コンフリクト解決のコツ
#

  • 頻繁にコードを pull する:機能開発中、定期的にdevelopブランチを自分の機能ブランチへマージし、自分のブランチが常に他人の作業と同期している状態にします。これにより潜在的なコンフリクトを早めに発見できます。
  • 明確なコミット履歴を保つ:コミット時に分かりやすいメッセージを書くことで、他の開発者が各コミットの目的を理解しやすくなります。

6. ロールバック操作
#

マージに失敗した場合、以下のコマンドでロールバックできます。

  • 最後のコミットを取り消す(まだ push していない場合):
    git reset --soft HEAD^
  • 特定のコミットへ戻す
    git reset --hard <commit-hash>

四、まとめ
#

複数人協作ではバージョンコンフリクトを完全に避けることはできません。しかし、適切な Git ブランチ戦略、定期的な pull、頻繁で小規模なコミット、コードレビューなどを通じて、コンフリクトを効果的に減らし、高効率に解決できます。各チームメンバーはできるだけ早くコンフリクトに対応し、発生時には落ち着いて丁寧に解決することで、コードの安定性と協作の円滑さを確保できます。