Khắc phục lỗi "*** Please tell me who you are" trong Git

Khi mới bước chân vào thế giới lập trình và làm quen với Git, chắc hẳn không ít bạn đã từng bối rối khi thực hiện lệnh commit đầu tiên nhưng lại bị hệ thống "từ chối" với dòng thông báo lỗi: *** Please tell me who you are. (Vui lòng cho tôi biết bạn là ai) cùng dòng chữ fatal: unable to auto-detect email address.

Đừng quá lo lắng! Đây hoàn toàn không phải là lỗi code hay máy tính bị hỏng. Nó chỉ là một bước thiết lập cơ bản mà bạn chưa thực hiện. Bài viết này sẽ giúp bạn hiểu rõ bản chất của vấn đề và cách khắc phục chỉ trong 1 phút.

1. Tại sao Git lại hỏi "Bạn là ai?"

Khác với việc lưu file thông thường (nhấn Ctrl + S) trên máy tính cá nhân, Git là một hệ thống quản lý phiên bản được sinh ra để phục vụ cho việc theo dõi lịch sử mã nguồn và làm việc nhóm.

Mỗi khi bạn lưu lại một trạng thái của dự án (thực hiện thao tác commit), Git cần biết chính xác ai là người đã thực hiện những thay đổi đó. Điều này giúp các thành viên trong team biết được dòng code này do ai viết, ai là người vừa sửa lỗi, hoặc ai vừa làm hỏng hệ thống.

Do đó, Git bắt buộc bạn phải tạo một cái "danh thiếp" bao gồm Tên và Email. Nếu hệ thống không tìm thấy thông tin này, nó sẽ chặn thao tác commit và yêu cầu bạn khai báo.

2. 2 Cách thiết lập định danh (Identity) trong Git

Bạn có thể báo cho Git biết bạn là ai thông qua một trong hai cách rất đơn giản sau đây:

Cách 1: Sử dụng Command Line (Khuyên dùng)

Đây là cách phổ biến nhất và có thể áp dụng trên mọi hệ điều hành (Windows, macOS, Linux).

1. Mở công cụ dòng lệnh của bạn lên (Terminal, Command Prompt, hoặc Git Bash).
2. Gõ lần lượt hai dòng lệnh dưới đây và nhấn Enter (nhớ thay đổi phần trong ngoặc kép thành thông tin của bạn):

git config --global user.name "Tên Của Bạn"
git config --global user.email "email_cua_ban@example.com"

Lưu ý: Cờ --global giúp bạn thiết lập thông tin này làm mặc định cho toàn bộ máy tính. Bạn chỉ cần làm việc này một lần duy nhất, các dự án sau này sẽ tự động sử dụng thông tin này.

Cách 2: Thiết lập qua giao diện phần mềm (Fork, SourceTree, GitKraken...)

Nếu bạn đang sử dụng các phần mềm quản lý Git có giao diện trực quan (GUI) như phần mềm Fork, bạn có thể thiết lập trực tiếp mà không cần gõ code:

1. Mở phần mềm lên và truy cập vào mục Preferences hoặc Settings (thường nằm ở menu File hoặc Edit).
2. Tìm đến tab Git.
3. Điền Tên và Email của bạn vào phần Default Identity (Định danh mặc định).
4. Lưu lại và thực hiện commit như bình thường.

3. Những hiểu lầm thường gặp: "Tôi nên dùng email nào?"

Rất nhiều người mới học cho rằng bước này là bước "Đăng nhập" và phải nhập đúng tài khoản, mật khẩu. Thực tế, thông tin này chỉ đơn thuần là một cái nhãn dán văn bản đính kèm vào code của bạn.

• Nếu bạn chỉ học code và làm dự án cá nhân trên máy: Bạn có thể điền bất cứ thứ gì bạn thích, kể cả một email không tồn tại (ví dụ: batman@gotham.com). Git vẫn sẽ chấp nhận.
• Nếu bạn đẩy code lên GitHub, GitLab: Lúc này, việc điền chính xác Email lại cực kỳ quan trọng. GitHub sẽ đối chiếu email trong từng commit của bạn với email tài khoản GitHub. Nếu trùng khớp, GitHub mới ghi nhận đóng góp và hiển thị các "ô vuông màu xanh" trên trang cá nhân của bạn.

Mẹo nhỏ nếu bạn quên email GitHub: Bạn không cần tạo tài khoản mới. Hãy đăng nhập vào trang chủ GitHub, vào Settings > Emails để xem danh sách các email bạn đã liên kết với tài khoản. Hãy copy một trong số các email đó và dán vào lệnh thiết lập của Git là xong.

Tổng kết

Lỗi Please tell me who you are chỉ là lời nhắc nhở thân thiện của Git yêu cầu bạn khai báo danh tính trước khi làm việc. Bằng cách chạy hai dòng lệnh git config cơ bản, bạn đã hoàn tất thủ tục "nhập môn" và sẵn sàng cho hành trình chinh phục các dự án phần mềm của mình. Chúc các bạn code vui vẻ!