Thực Hành Tốt Để Tương Lai Bạn Sẽ Cảm Ơn
Khi bắt đầu sự nghiệp lập trình viên, bạn có thể dễ dàng tập trung vào việc làm cho mã hoạt động. Tuy nhiên, nếu bạn muốn cuộc sống của mình trở nên dễ dàng hơn trong tương lai (và cho cả đồng đội của bạn), có một số thói quen đáng để xây dựng từ sớm. Những điều nhỏ này sẽ tích lũy theo thời gian và khi bạn trở thành lập trình viên senior, chúng sẽ trở thành bản năng.
Viết Thông Điệp Commit Rõ Ràng
Thông điệp commit như "Sửa lỗi" hay "Cập nhật mã" không giúp ích gì khi bạn cố gắng hiểu lịch sử mã trong nhiều tháng sau. Một thông điệp commit tốt nên giải thích tại sao thay đổi được thực hiện, chứ không chỉ cái gì bạn đã thay đổi.
Ví Dụ Về Thông Điệp Commit
- Xấu: "Sửa lỗi"
- Tốt: "Sửa lỗi không hiển thị thông báo khi người dùng đăng nhập"
Tài Liệu Khi Bạn Làm
Bạn không cần phải viết tiểu thuyết, nhưng ghi lại lý do bạn đưa ra quyết định nào đó sẽ giúp bạn không phải học lại sau này. Một README ngắn, một chú thích giải thích một hàm phức tạp, hoặc thậm chí một ADR (bản ghi quyết định kiến trúc) sẽ rất hữu ích.
Tài Liệu Ví Dụ
- README: Giới thiệu về dự án và cách sử dụng nó.
- Chú Thích: Giải thích chức năng của một hàm phức tạp trong mã.
Học Đọc Trước Khi Viết
Trước khi bạn thêm mã mới, hãy dành thời gian để hiểu những gì đã có. Phần lớn sự nghiệp của bạn sẽ là đọc và duy trì mã hiện có — không phải viết các tính năng mới từ đầu. Hãy trở nên thành thạo trong việc điều hướng các cơ sở mã ngay từ đầu.
Mẹo Đọc Mã
- Sử Dụng Công Cụ: Sử dụng các công cụ như IDE để tìm kiếm và điều hướng mã.
- Ghi Chú: Ghi lại các điểm quan trọng khi bạn đọc mã để dễ dàng tham khảo sau này.
Sự Nhất Quán Hơn Là Sự Khéo Léo
Mã khéo léo có thể gây ấn tượng với bản thân bạn hiện tại, nhưng mã rõ ràng và nhất quán sẽ giúp bạn trong tương lai (và cả đồng đội của bạn). Hãy tuân thủ các quy ước của đội, làm theo hướng dẫn phong cách và hướng tới khả năng đọc hiểu hơn là sự xuất sắc.
Hướng Dẫn Để Giữ Sự Nhất Quán
- Quy Tắc Đặt Tên: Sử dụng quy tắc đặt tên nhất quán cho biến và hàm.
- Phong Cách Lập Trình: Theo dõi quy tắc phong cách lập trình mà đội bạn đã thống nhất.
Tự Động Hóa Những Việc Tẻ Nhạt
Nếu bạn nhận thấy mình lặp lại các bước thủ công giống nhau — thiết lập môi trường, chạy thử nghiệm, định dạng mã — hãy dành thời gian để tự động hóa chúng. Các kịch bản và công cụ có thể cảm thấy thừa thãi ngay bây giờ, nhưng chúng tiết kiệm hàng giờ (và sai sót) trong tương lai.
Ví Dụ Về Tự Động Hóa
- Scripts: Viết script để tự động hóa quy trình kiểm tra.
- Công Cụ: Sử dụng công cụ CI/CD để tự động hóa triển khai.
Bắt đầu thực hành những thói quen này ngay hôm nay, và tương lai bạn sẽ cảm ơn bạn vì đã làm như vậy. Hoặc có thể là khi bạn nhận ra việc gỡ lỗi mã của chính mình từ năm trước là… bất ngờ dễ dàng.
Những Lời Khuyên Thực Tế
- Hãy tạo thói quen viết commit rõ ràng ngay từ đầu.
- Đừng ngại yêu cầu đồng đội giúp đỡ trong việc ghi chú và tài liệu.
Những Cạm Bẫy Thường Gặp
- Không ghi chú lại lý do thay đổi có thể dẫn đến việc mất nhiều thời gian hơn để hiểu mã.
- Không tuân thủ quy tắc phong cách có thể khiến mã khó đọc hơn.
Lời Kết
Hãy bắt đầu xây dựng những thói quen tốt ngay bây giờ để tương lai bạn sẽ không phải hối tiếc. Việc lập trình không chỉ là về việc viết mã, mà còn là về cách bạn duy trì và cải thiện nó theo thời gian.
