Commit & Push

Stage tệp, viết commit message thủ công hoặc nhờ AI agent viết, rồi push lên remote chỉ với vài cú nhấp.

Khi bạn đã xem xét diff và hài lòng với những gì AI agent đã thay đổi, đã đến lúc commit và push. Hướng dẫn này đi qua toàn bộ quy trình, từ stage đến push lên remote repository của bạn.

Stage thay đổi

Stage cho phép bạn chọn chính xác những thay đổi nào sẽ nằm trong commit này. Ví dụ, bạn có thể muốn commit code tính năng tách riêng với một thay đổi cấu hình.

Trong Git panel, mọi tệp đã chỉnh sửa đều xuất hiện trong mục Unstaged Changes:

  • Chọn checkbox bên cạnh một tệp để stage riêng tệp đó
  • Nhấp Stage All để stage toàn bộ tệp đã thay đổi cùng lúc
  • Để unstage một tệp, bỏ chọn checkbox — tệp sẽ quay lại mục Unstaged

Các tệp đã stage sẽ chuyển vào mục Staged Changes ở đầu thanh bên. Chỉ những tệp đã stage mới được đưa vào commit.

Bạn cũng có thể stage từng hunk (một đoạn của tệp) thay vì cả tệp. Trong chế độ xem diff, di chuột qua một hunk và nhấp nút + xuất hiện để chỉ stage đoạn đó. Cách này hữu ích khi một tệp có hai thay đổi không liên quan và bạn chỉ muốn commit một trong hai ngay lúc này.

Xem thay đổi dạng cây thư mục

Agent thường tạo ra các diff rộng và nông — một thay đổi chạm tới bốn thư mục và mười tám tệp là chuyện bình thường. Danh sách phẳng biến điều đó thành mười tám dòng với đường dẫn gần như giống hệt nhau.

Một nút chuyển cạnh ô Filter cho phép đổi danh sách Changes giữa dạng danh sách phẳng và dạng cây thư mục kiểu VS Code, và lựa chọn của bạn sẽ được ghi nhớ cho lần mở hộp thoại tiếp theo.

Hộp thoại Git Changes ở chế độ cây thư mục, 18 tệp thay đổi được lồng trong scripts, src/main/database/adapters và renderer/components, mỗi dòng thư mục có một checkbox stage riêng

  • Checkbox của thư mục sẽ stage hoặc unstage mọi thứ bên dưới nó chỉ với một cú nhấp, nên việc xem xét theo khu vực và stage theo khu vực là cùng một thao tác.
  • Dấu gạch ngang trên thư mục nghĩa là thư mục đó được stage một phần. Stage một phần rất dễ vô tình tạo ra và gần như không thể nhận thấy trong danh sách phẳng; checkbox ba trạng thái làm lộ điều này ở cấp thư mục.
  • Thu gọn tất cả / mở rộng tất cả giúp xử lý tập thay đổi trải rộng trên nhiều thư mục.

Danh sách phẳng vẫn giữ nguyên và vẫn hiển thị đường dẫn đầy đủ trên mỗi dòng, dành cho trường hợp tập thay đổi đủ nhỏ để việc nhóm chỉ thêm một cú nhấp thừa.

Viết commit message

Sau khi đã stage tệp, hãy nhập commit message vào ô văn bản ở cuối Git panel.

Một commit message tốt giúp lịch sử của bạn dễ đọc — cho chính bạn trong tương lai và cho bất kỳ ai khác trong dự án. Vài mẹo:

  • Dùng thể mệnh lệnh — viết "Add login form" thay vì "Added login form" hay "Adding login form"
  • Mô tả thay đổi gì và vì sao — "Fix null check in user.ts" hữu ích hơn "fix bug"
  • Giữ dòng đầu dưới 72 ký tự — hầu hết công cụ git sẽ cắt bớt các message dài hơn trong chế độ xem danh sách
  • Thêm phần thân nếu cần — nhấn Enter hai lần sau dòng đầu để thêm phần giải thích dài hơn bên dưới

Ví dụ về các commit message rõ ràng:

  • Add email validation to signup form
  • Fix crash when user list is empty
  • Update API base URL for production

Để agent viết giúp

Nút sparkle trong phần tóm tắt commit sẽ chuyển diff của bạn cho một AI CLI đã cài đặt và yêu cầu nó viết message.

  • Ghim agent sẽ viết, hoặc để 1DevTool dùng agent đầu tiên mà bạn đã cài. Kimi Code nằm trong danh sách cùng với các agent khác. Khi cài nhiều agent, menu sẽ vừa với cửa sổ và có thể cuộn.
  • Chọn một phong cách: Conventional, Plain hoặc Gitmoji.
  • Khi chưa stage gì, nó sẽ dùng diff của working tree — nên bạn có thể có message trước khi quyết định stage gì.

Kết quả xuất hiện trong ô message dưới dạng văn bản thông thường có thể chỉnh sửa. Đó là bản nháp, không phải một commit.

Commit

Nhấp nút Commit bên dưới ô message. Các thay đổi đã stage được lưu vào lịch sử git cục bộ dưới dạng một commit mới, và mục tệp đã stage được dọn sạch.

Commit giờ xuất hiện trong lịch sử nhánh của bạn. Nếu cần hoàn tác, nhấp chuột phải vào commit trong chế độ xem lịch sử và chọn Undo Commit — thao tác này đưa các thay đổi trở lại tệp unstaged mà không làm mất chúng.

Push lên remote

Commit chỉ lưu thay đổi cục bộ. Để gửi chúng lên GitHub, GitLab hoặc remote khác của bạn:

  1. Nhấp nút Push trên thanh công cụ của Git panel (biểu tượng mũi tên lên)
  2. Nếu nhánh đã tồn tại trên remote, các commit của bạn được push ngay lập tức
  3. Nếu là nhánh mới chưa có trên remote, nhấp Publish Branch — thao tác này tạo nhánh trên remote và push các commit của bạn

Nếu được yêu cầu nhập thông tin xác thực, bạn có thể nhập hoặc chuyển sang xác thực bằng SSH key. Xem Git Accounts để biết cách kết nối tài khoản GitHub của bạn để thông tin xác thực được xử lý tự động.

Push nhánh mới lên Git

Pull thay đổi

Để lấy các thay đổi từ remote về (ví dụ, khi đồng đội đã push thứ gì đó):

  1. Nhấp nút Pull (biểu tượng mũi tên xuống) trên thanh công cụ
  2. Các thay đổi từ remote được fetch và merge vào nhánh cục bộ của bạn

Nếu có xung đột merge, Git panel sẽ đánh dấu các tệp xung đột. Mở từng tệp để giải quyết xung đột, sau đó stage và commit phần đã giải quyết.

Nút nhanh để thêm git

Sau khi push, các thay đổi của bạn đã nằm trên remote và sẵn sàng cho đồng đội hoặc cho một pull request. Git panel cho thấy nhánh của bạn đã được cập nhật so với remote.