HƯỚNG DẪN TOÀN TẬP: TỪ BƯỚC FORK REPOSITORY ĐẾN THAO TÁC TRÊN NHÁNH RIÊNG

Để làm việc chuyên nghiệp với một dự án mã nguồn mở hoặc dự án của công ty thông qua mô hình Fork & Pull Request, bạn hãy thực hiện tuần tự theo 5 bước chuẩn mực sau:

1. Bước 1: Tiến hành Fork Repository

Thao tác trực tiếp trên giao diện GitHub / GitLab.

Truy cập vào trang chủ của repository gốc mà bạn muốn tham gia đóng góp.
Tìm và bấm vào nút Fork (nằm ở góc trên bên phải màn hình, cạnh nút Star).
Đặt tên lại (nếu muốn) và chọn Owner là tài khoản cá nhân của bạn, sau đó nhấn Create fork.

Kết quả: Bạn đã có một bản sao độc lập của dự án nằm ngay trong tài khoản GitHub của chính mình.

2. Bước 2: Clone Repository về máy (Local)

Sao chép bản sao của bạn về máy tính cá nhân.

Vào trang repo đã Fork của chính bạn, bấm nút xanh Code và copy đường dẫn HTTPS hoặc SSH.
Mở Terminal (hoặc Git Bash) trên máy tính và chạy lệnh:

git clone <đường_dẫn_git_vừa_copy>
cd <tên_thư_mục_vừa_tải>

Lệnh này sẽ tải toàn bộ mã nguồn về máy tính và tự động cấu hình remote mặc định có tên là origin trỏ về repo của bạn.

3. Bước 3: Thiết lập Upstream Remote (Cực kỳ quan trọng)

Kết nối với repo gốc để cập nhật code mới sau này. Vì repo gốc (upstream) sẽ liên tục có người khác đóng góp code mới, bạn cần tạo một đường dẫn kết nối phụ để kéo những thay đổi đó về sau này. Chạy lệnh sau trên terminal:

# Thêm remote upstream trỏ đến repo gốc của người khác/công ty
git remote add upstream <url_repository_gốc>

# Kiểm tra lại danh sách các remote hiện tại
git remote -v

(Bạn sẽ thấy origin trỏ về repo của bạn, và upstream trỏ về repo gốc).

4. Bước 4: Tạo và chuyển sang nhánh làm việc riêng (Feature Branch)

Không bao giờ viết code trực tiếp trên nhánh chính (main/master). Trước khi gõ bất kỳ dòng code nào, hãy luôn tạo cho mình một nhánh (branch) riêng biệt mang tên tính năng hoặc tên bạn:

# Đảm bảo bạn đang ở nhánh main và đã cập nhật code mới nhất từ origin
git checkout main
git pull origin main

# Tạo và chuyển ngay sang một nhánh làm việc mới (ví dụ: feature/login-api)
git checkout -b feature/login-api

(Hoặc dùng lệnh rút gọn từ git hiện đại: git switch -c feature/login-api).

5. Bước 5: Thao tác code và Push lên nhánh riêng

Tiến hành code, commit và đẩy (push) lên repo của bạn. Bây giờ, hãy mở IDE (VS Code, PhpStorm...) lên và tiến hành viết code, sửa lỗi tùy ý trên nhánh feature/login-api vừa tạo.

Sau khi hoàn thành một phần công việc, thực hiện các bước lưu trữ:

# Kiểm tra những file đã thay đổi
git status

# Thêm file vào vùng đệm
git add .

# Lưu lại trạng thái kèm thông điệp rõ ràng
git commit -m "feat: implement user login api logic"

# Đẩy nhánh này từ máy tính lên repo Fork của bạn trên GitHub lần đầu tiên
git push -u origin feature/login-api

Từ các lần push tiếp theo, bạn chỉ cần gõ gọn gàng lệnh: git push.

💡 Lời Khuyên Cho Kỹ Sư Khi Làm Việc Với Fork

Giữ nhánh Main luôn sạch sẽ: Tuyệt đối không git push trực tiếp code chưa test lên nhánh main hay master.
Đồng bộ code thường xuyên: Trước khi bắt đầu một ngày làm việc mới, hãy nhớ chạy lệnh git fetch upstream rồi git merge upstream/main để kéo code mới nhất từ repo gốc về máy, tránh việc xung đột code (Merge Conflict) về sau.

forked