Đổi tên nhánh Git: Cách đổi tên nhánh cục bộ hoặc từ xa

Đổi tên nhánh cục bộ

Đổi tên một nhánh cục bộ là cách đơn giản nhưng hiệu quả để giữ dự án gọn gàng và đảm bảo tên nhánh phản ánh chính xác nội dung hoặc mục đích của nó.

Đổi tên nhánh cục bộ không làm đổi tên nhánh đó trên kho từ xa. Nếu nhánh được theo dõi trên remote, chúng ta cần xử lý riêng.

Điều kiện tiên quyết

Trước khi bắt đầu, cần đảm bảo Git đã được cài đặt và chúng ta đang ở thư mục repository trên máy cục bộ.

• Kiểm tra cài đặt: Đảm bảo bạn đã cài Git cục bộ. Có thể kiểm tra bằng cách chạy git --version trong terminal hoặc command prompt. Nếu chưa cài, hãy đọc hướng dẫn cài đặt Git này hoặc truy cập trang web chính thức của Git để tải về và xem hướng dẫn cài đặt.
• Đi đến thư mục repository: Bắt đầu bằng cách mở terminal hoặc command prompt và điều hướng đến thư mục của dự án Git mà chúng ta muốn đổi tên nhánh.

Checkout nhánh

Trước khi làm gì với nhánh, trước hết cần chuyển sang nhánh đó bằng lệnh:

git checkout <current_branch_name>

Thay <current_branch_name> bằng tên hiện tại của nhánh.

Đổi tên nhánh

Sau khi checkout nhánh, đổi tên nhánh bằng:

git branch -m <new_branch_name>

Thay <new_branch_name> bằng tên mới của nhánh.

Xác minh

Chúng ta có thể xác minh tên đã được đổi bằng cách liệt kê tất cả nhánh với lệnh git branch. Nhánh hiện tại sẽ có dấu hoa thị (*) bên cạnh.

Đổi tên nhánh từ xa

Đổi tên một nhánh từ xa trong Git bao gồm thêm một vài bước để đảm bảo thay đổi được phản ánh trên kho từ xa.

Đẩy các thay đổi cục bộ

Trước khi đổi tên nhánh từ xa, chúng ta nên đảm bảo nhánh cục bộ không chứa công việc chưa có trên nhánh từ xa. Điều này ngăn các thay đổi bị mất trong quá trình đổi tên. Nếu bạn chưa chắc cách đẩy thay đổi, hãy xem Hướng dẫn Git Push và Pull này.

Đổi tên nhánh cục bộ

Trước khi đổi tên nhánh từ xa, trước hết chúng ta cần đổi tên nhánh ở cục bộ, như đã học ở trên.

Đẩy nhánh mới

Sau khi đổi tên nhánh ở cục bộ, chúng ta có thể đẩy nhánh mới đó lên kho từ xa bằng:

git push origin -u <new_branch_name>

Tùy chọn -u đặt nhánh được đẩy làm upstream cho nhánh cục bộ. Điều này giúp các lần push và pull sau này từ nhánh này tự động tham chiếu đến remote với tên mới.

Xóa nhánh cũ

Quy trình này không đổi tên một nhánh trên remote mà tạo một bản sao mới với tên mới. Vì vậy sau đó, khuyến nghị dọn dẹp repository bằng cách xóa nhánh cũ với lệnh sau:

git push origin --delete <old_branch_name>

Nếu bạn muốn mở rộng kiến thức về làm việc với nhánh trong Git, hãy xem hướng dẫn Git Clone một nhánh cụ thể.

Những lưu ý quan trọng

Khi đổi tên một nhánh từ xa trong Git, có một số khía cạnh quan trọng cần chú ý để đảm bảo quá trình diễn ra suôn sẻ và không làm gián đoạn quy trình làm việc của các cộng tác viên.

Chúng ta luôn nên thông báo cho các thành viên trong nhóm về việc đổi tên nhánh. Việc này giúp tránh nhầm lẫn, vì họ có thể gặp lỗi nếu cố pull hoặc push vào một nhánh không còn tồn tại với tên cũ.

Cộng tác viên nên đổi tên bản sao nhánh cục bộ của họ bằng lệnh git branch -m <old_branch_name> <new_branch_name>. Ngoài ra, họ sẽ cần đặt lại upstream bằng git push origin -u <new_branch_name> để các lần push sau đi đến đúng nhánh.

Nếu có bất kỳ pull request đang mở nào nhắm vào tên nhánh cũ trên kho từ xa, chúng cần được xử lý. Có thể cần đóng chúng và tạo pull request mới nhắm vào nhánh vừa đổi tên.

Đổi tên nhánh trong các client Git

Hầu hết các client Git (ví dụ GitHub, GitKraken, Sourcetree, GitLab, v.v.) cung cấp tùy chọn đổi tên nhánh qua giao diện đồ họa.

Để đổi tên nhánh trên GitHub, bắt đầu bằng cách truy cập repository. Sau đó nhấp vào menu thả xuống nhánh:

Ở cuối menu, nhấp Xem tất cả nhánh:

Tiếp theo, tìm nhánh muốn đổi tên và nhấp menu ba chấm ở bên phải:

Cuối cùng, nhấp Tùy chọn đổi tên nhánh và đổi tên nhánh:

Kết luận

Đổi tên nhánh trong Git đóng vai trò then chốt trong việc duy trì cấu trúc dự án hiệu quả và trực quan. 

Cần phân biệt giữa việc đổi tên nhánh cục bộ và từ xa, vì mỗi cách có bộ bước thực hiện và tác động riêng đến quy trình làm việc.

Quan trọng hơn, giao tiếp với nhóm là tối quan trọng. Giữ mọi người được thông báo giúp chuyển đổi liền mạch và tránh gián đoạn chu kỳ phát triển.

Nếu bạn muốn tìm hiểu thêm về Git, tôi khuyến nghị khóa học nhập môn Git này.