Trong quá trình làm việc nhóm với Git, xung đột mã nguồn (Merge Conflict) là điều khó tránh khỏi. Dù bạn là Lập trình viên mới hay đã có kinh nghiệm, việc nắm vững cách xử lý Git Merge Conflict không chỉ giúp bảo vệ code base an toàn mà còn tối ưu hóa quy trình làm việc chuyên nghiệp.

Bài viết này từ DCSoftTech sẽ hướng dẫn chi tiết bản chất của Merge Conflict và các bước xử lý từng bước một cách chuẩn xác nhất.

1. Git Merge Conflict Là Gì? Vì Sao Lại Xảy Ra?

Git Merge Conflict (Xung đột khi hợp nhất) xảy ra khi Git không thể tự động hợp nhất các thay đổi từ hai nhánh (branch) khác nhau.

          C3 - C4 (Branch Feature)
         /
C1 - C2 
         \
          C5 - C6 (Branch Main)

Nguyên nhân phổ biến gây ra Conflict:

• Sửa cùng một dòng code: Hai người cùng chỉnh sửa một dòng lệnh trên cùng một file ở 2 nhánh khác nhau.

• Xóa file đang được chỉnh sửa: Một nhánh thực hiện xóa file, trong khi nhánh còn lại tiếp tục sửa đổi file đó.

• Gộp nhánh thiếu đồng bộ: Nhánh cá nhân chưa cập nhật những thay đổi mới nhất từ nhánh chính (main/master) trước khi tạo Pull Request (PR).

2. Các Bước Xử Lý Git Merge Conflict Thủ Công

Khi xảy ra xung đột, Git sẽ tạm dừng quá trình merge và đánh dấu vị trí bị lỗi trong file. Bạn có thể tự tay xử lý theo 4 bước sau:

Bước 1: Xác định danh sách các file bị xung đột

Mở Terminal/Command Prompt tại thư mục dự án và chạy lệnh:

git status

Git sẽ liệt kê các file nằm trong trạng thái Unmerged paths (màu đỏ).

Bước 2: Kiểm tra và sửa nội dung bị xung đột

Mở file bị lỗi bằng code editor (VS Code, WebStorm,…). Bạn sẽ thấy Git chèn các ký tự đánh dấu xung đột:

<<<<<<< HEAD
// Code hiện tại trên nhánh của bạn (Current Change)
console.log("Hello from DCSoftTech");
=======
// Code từ nhánh bạn muốn gộp vào (Incoming Change)
console.log("Welcome to DCSoftTech Studio");
>>>>>>> feature-branch

• <<<<<<< HEAD: Bắt đầu đoạn code trên nhánh bạn đang làm việc.

• =======: Ranh giới phân chia giữa 2 phiên bản.

• >>>>>>> [branch-name]: Kết thúc đoạn code từ nhánh được hợp nhất.

Cách xử lý:

• Giữ lại phần code đúng nhất hoặc kết hợp cả hai.

• Xóa toàn bộ các đường kẻ đánh dấu (<<<<<<<, =======, >>>>>>>).

Bước 3: Đánh dấu file đã giải quyết xong

Sau khi sửa code và lưu file, thông báo cho Git biết file đã được xử lý bằng lệnh add:

git add <tên-file-đã-sửa>
# Hoặc thêm tất cả các file đã sửa:
git add .

Bước 4: Hoàn tất quá trình Merge

Tạo một commit hoàn tất việc xử lý xung đột:

git commit -m "Fix: Resolve merge conflict between main and feature branch"

3. Công Cụ Hỗ Trợ Xử Lý Merge Conflict Hiệu Quả

Nếu không muốn sửa thủ công từng ký tự trong Terminal, bạn có thể tận dụng các công cụ GUI hiện đại:

4. Giải Pháp Huỷ Lệnh Merge Khi Gặp Sự Cố

Trong trường hợp xung đột quá phức tạp và bạn muốn quay về trạng thái an toàn ban đầu trước khi merge, hãy dùng lệnh hủy:

git merge --abort

Lệnh này sẽ khôi phục nhánh của bạn về trạng thái ngay trước khi thực hiện lệnh git merge.

5. Mẹo Hạn Chế Merge Conflict Trong Dự Án Team (DCSoftTech Best Practices)

Để tối ưu quy trình làm việc tại DCSoftTech, các kỹ sư phần mềm thường áp dụng các nguyên tắc sau:

1. Rebase/Pull thường xuyên: Thường xuyên cập nhật code mới từ main về nhánh feature cá nhân bằng git pull origin main hoặc git rebase main.

2. Chia nhỏ Task & Commit: Không giữ nhánh quá lâu. Làm xong tính năng nào hãy tạo PR và gộp nhánh ngay.

3. Giao tiếp trong team: Thông báo cho đồng nghiệp khi thay đổi cấu trúc thư mục hoặc sửa các file cấu hình dùng chung (package.json, .env,…).