Git stash: lưu tạm công việc dở và khôi phục đúng lúc

Bạn đang làm dở một feature phức tạp, code đang lủng củng giữa chừng — thì Product Manager gửi Slack: “Fix bug này gấp, ảnh hưởng khách hàng!”. Nếu commit lúc này thì lịch sử git sẽ có một commit rác. Nếu không commit thì không chuyển nhánh được. Đây chính xác là tình huống git stash được sinh ra để giải quyết.

Git stash là gì và khi nào cần dùng?

Git stash là lệnh lưu tạm toàn bộ thay đổi chưa commit vào một stack riêng, trả working directory về trạng thái sạch (HEAD), giúp bạn chuyển task mà không cần commit vội.

Về bản chất, cơ chế này hoạt động như một “ngăn kéo” — bạn nhét mọi thứ đang dở vào đó, làm việc khác xong rồi lấy ra tiếp tục. Không có giới hạn số lượng mục lưu trữ, và mọi thứ được quản lý theo dạng LIFO (Last In, First Out) — phần tử mới nhất luôn ở trên cùng.

Git stash

Lệnh lưu tạm thay đổi chưa commit (cả staged lẫn unstaged) vào một stack riêng biệt với lịch sử commit, cho phép working directory trở về trạng thái HEAD sạch.

Các tình huống thực tế thường gặp:

• Đang làm feature A, có bug khẩn cấp cần fix trên nhánh khác
• Muốn kéo mã nguồn mới nhất từ remote nhưng đang có thay đổi chưa xong
• Cần test một cách làm khác mà không muốn mất code hiện tại
• Lỡ bắt đầu làm trên nhánh sai, cần chuyển sang nhánh đúng

Cách dùng cơ bản: save, pop, apply

Ba thao tác cốt lõi gồm lưu (save), lấy ra và xóa khỏi ngăn chứa (pop), hoặc lấy ra nhưng giữ lại bản lưu (apply).

Giả sử bạn đang làm dở feature trên nhánh feature/login:

# Kiểm tra trạng thái hiện tại
git status
# On branch feature/login
# Changes not staged for commit:
#   modified: src/auth/login.js
# Untracked files:
#   src/auth/oauth.js

# Lưu tạm toàn bộ thay đổi
git stash
# Saved working directory and index state WIP on feature/login: a3f2b1c Add base login form

# Working directory đã sạch — có thể chuyển nhánh
git checkout main
git checkout -b hotfix/payment-null-check
# ... fix bug, commit, push ...

# Quay lại nhánh cũ và lấy code ra
git checkout feature/login
git stash pop
# On branch feature/login
# Changes not staged for commit:
#   modified: src/auth/login.js

Khác biệt giữa pop và apply:

• pop: Áp thay đổi vào working directory và xóa khỏi ngăn chứa. Dùng khi chắc chắn không cần dùng lại bản này.
• apply: Áp thay đổi nhưng giữ nguyên trong ngăn chứa. Rất tiện khi muốn áp cùng một đoạn code thử nghiệm vào nhiều nhánh khác nhau.

# Apply nhưng giữ lại bản lưu
git stash apply

# Hoặc chỉ định bản lưu cụ thể
git stash apply stash@{2}

Bạn cũng có thể gắn kèm mô tả rõ ràng để dễ nhận biết sau này:

git stash save "WIP: login form với OAuth2 flow"
# hoặc cú pháp mới hơn:
git stash push -m "WIP: login form với OAuth2 flow"

Bạn đang đọc bài viết thuộc chuyên mục Lập trình của VietnamTutor — nơi mình chia sẻ kinh nghiệm thực chiến về Git, DevOps và workflow lập trình hàng ngày.

Quản lý nhiều bản lưu: list, show, drop

Hệ thống cho phép lưu trữ nhiều mục cùng lúc; dùng git stash list để kiểm tra toàn bộ, git stash show để xem chi tiết, và git stash drop hoặc git stash clear để dọn dẹp.

# Xem danh sách tất cả stash
git stash list
# stash@{0}: On feature/login: WIP: login form với OAuth2 flow
# stash@{1}: WIP on feature/dashboard: add chart component
# stash@{2}: WIP on main: quick experiment

# Xem tóm tắt những gì có trong stash@{1}
git stash show stash@{1}

# Xem diff đầy đủ của stash@{1}
git stash show -p stash@{1}

# Áp một stash cụ thể
git stash apply stash@{1}

# Xóa một stash cụ thể
git stash drop stash@{2}

# Xóa toàn bộ stash (cẩn thận!)
git stash clear

Lưu ý quan trọng về indexing stash: Mỗi khi bạn stash mới, index sẽ dịch chuyển. Stash cũ nhất không phải lúc nào cũng là stash@{0} sau khi thêm stash mới. Hãy luôn chạy git stash list trước khi apply để tránh áp nhầm.

Xử lý untracked và ignored files

Mặc định, công cụ chỉ lưu các tệp đã được theo dõi (staged hoặc modified). Để lưu thêm các tệp chưa theo dõi (untracked files), hãy thêm cờ -u; để bao gồm toàn bộ tệp bị bỏ qua (ignored), dùng -a.

# Chỉ lưu tracked files (mặc định)
git stash

# Lưu cả untracked files (file mới chưa git add)
git stash -u
# hoặc
git stash --include-untracked

# Lưu tất cả kể cả ignored files (dùng cẩn thận)
git stash -a
# hoặc
git stash --all

Trong thực tế, -u là tùy chọn cần thiết nhất. Ví dụ: bạn tạo file src/auth/oauth.js mới nhưng chưa git add — nếu không dùng -u, file này sẽ không được cất đi và vẫn còn trong working directory sau khi chuyển nhánh.

Trường hợp cất tạm một phần file (partial stash):

# Interactive: chọn từng hunk để lưu
git stash -p
# hoặc
git stash --patch

# Chỉ lưu một file cụ thể
git stash push -m "only login.js" -- src/auth/login.js

Tính năng lưu theo phần rất hữu ích khi bạn muốn commit một phần thay đổi nhưng giữ lại phần còn lại để làm tiếp sau. Tham số -p hoạt động tương tự git add -p, cho phép xem lại từng đoạn mã.

Xem thêm các lệnh Git liên quan: git commit nhầm file — cách sửa an toàn và git reset vs revert vs restore: chọn lệnh đúng.

Tạo nhánh từ bản lưu khi bị xung đột

Khi khôi phục vào nhánh mà mã nguồn đã thay đổi nhiều, có thể xảy ra xung đột. Giải pháp an toàn nhất là tạo nhánh mới trực tiếp bằng cú pháp git stash branch <tên-nhánh>.

# Tạo nhánh mới từ stash@{0} (mặc định là bản mới nhất)
git stash branch feature/login-v2

# Hoặc từ bản lưu cụ thể
git stash branch feature/dashboard-chart stash@{1}

Lệnh này tự động thực hiện:

1. Chuyển về commit mà tại đó bản lưu được tạo ra
2. Tạo một nhánh mới độc lập từ điểm đó
3. Áp toàn bộ thay đổi vào nhánh mới
4. Xóa bản lưu khỏi ngăn chứa nếu áp thành công

Đây là phương pháp giải quyết tối ưu khi bản cất giữ đã quá cũ và mã nguồn cơ sở đã khác biệt nhiều. Thay vì phải xử lý xung đột phức tạp, bạn có một nhánh riêng với điểm bắt đầu chính xác — rất dễ đánh giá và tích hợp sau này.

Tip thực chiến: dùng stash đúng cách

Lệnh lưu tạm này chỉ là công cụ hỗ trợ ngắn hạn, không phải giải pháp sao lưu lâu dài. Luôn đặt thông điệp rõ ràng, kiểm tra danh sách thường xuyên và dọn dẹp các mục cũ để tránh nhầm lẫn.

Tip 1: Luôn đặt tên khi lưu

# Không nên (khó nhớ sau vài ngày)
git stash

# Nên (mô tả rõ đang làm gì)
git stash push -m "WIP: refactor auth middleware — chưa xong phần token refresh"

Tip 2: Không lưu trữ quá lâu

Dữ liệu tạm không đồng bộ lên máy chủ từ xa — nếu máy tính gặp sự cố, công việc chưa commit sẽ mất. Nếu một thay đổi cần giữ qua nhiều ngày, hãy tạo nhánh WIP riêng. Theo thống kê từ các nhóm kỹ sư phần mềm [1], việc cất giữ tạm thời lý tưởng chỉ nên tồn tại trong phạm vi một buổi làm việc.

Tip 3: Xem trước thay đổi khi khôi phục

# Luôn kiểm tra nội dung trước khi pop
git stash show -p stash@{0}

# Sau đó mới pop
git stash pop

Tip 4: Dọn dẹp dữ liệu cũ định kỳ

# Xem stash nào cũ/không cần nữa
git stash list

# Xóa stash cụ thể
git stash drop stash@{3}

# Hoặc xóa tất cả (đảm bảo không cần trước khi clear)
git stash clear

Tip 5: Kết hợp với alias rút gọn

# Thêm vào ~/.gitconfig để dùng nhanh
git config --global alias.ss 'stash save'
git config --global alias.sl 'stash list'
git config --global alias.sp 'stash pop'

# Sau đó dùng:
git ss "WIP: login form"
git sl
git sp

Nguồn tham khảo

1. Git Official Documentation — git-stash
2. Atlassian Git Tutorials — Git stash
3. Stack Overflow — Recover stashed changes after accidental drop
4. Julia Evans — Inside .git (2024)
5. Oh Shit, Git!? — Common Git mistakes and fixes

Nếu bạn đang gặp vấn đề với Git workflow, VietnamTutor có thể hỗ trợ thiết lập quy trình làm việc chuẩn cho team — từ branching strategy, code review process đến CI/CD automation. Liên hệ để được tư vấn miễn phí.