/ Góc Học Tập

Viết comment trong code sao cho hiệu quả?

Viết comment trong code để ghi chú, để người khác hiểu đoạn code ấy. Vậy nên viết comment trong code như thế nào? Itexpress.edu.vn sẽ hướng dẫn bạn.

Viết comment trong code sao cho hiệu quả?

Nếu việc comment trong code bị hiểu sai và lạm dụng một cách tràn lan thì hãy cẩn thận nhé bạn. Chúng ta sẽ cùng thảo luận về vấn đề này.

Đây là một đoạn code mà không có bất kỳ chút comment nào:

Viết comment trong code

Bạn có bất kỳ ý nghĩ nào về điều mà đoạn code đó làm không? Nó thì hoàn toàn dễ đọc, nhưng nó đang làm cái quái gì thế?

Hãy bổ sung thêm một dòng comment nhé.

Viết comment trong code sao cho hiệu quả?

Đó có phải là điều mà tôi đang tìm kiếm, đúng không nào? Có một chút dễ chịu hơn, và đã tiến tới điểm giữa của con đường thỏa hiệp giữa hai thái cực là không có comment chút nào cả và có một comment tràng giang đại hải sau mỗi 2 dòng code?

Không chính xác là vậy. Thay vì bổ sung thêm một comment, thì tôi thích sửa nó lại thế này hơn:

Viết comment trong code sao cho hiệu quả?

Tôi đã không bổ sung thêm bất kỳ một dòng comment nào, và bây giờ thì đoạn code khó hiểu đó đã hoàn toàn rõ như ban ngày.

Trong khi các comment trong code vốn đã hoặc là tốt hoặc là tồi, chúng thường xuyên được sử dụng như một vật chống đỡ. Bạn nên luôn luôn viết code như thể là các dòng comment không tồn tại vậy. Điều này ép buộc bạn phải viết code của mình sao cho đơn giản nhất, rõ ràng nhất, và hầu như phần code đó tự bản thân nó đã nói lên chức năng của nó làm gì rồi.

Khi bạn đã rewritten, refactored, và rearchitected phần code của mình hàng tá lần để khiến cho nó trở nên dễ dàng cho các lập trình viên đồng nghiệp của bạn có thể đọc và hiểu được — khi bạn không thể tưởng tượng ra bất kỳ cách nào để code của bạn có thể trở nên rõ ràng và dễ hiểu hơn — thì, và chỉ khi đó, bạn mới cảm thấy vạn bất đắc dĩ bổ sung thêm một comment để giải thích điều mà đoạn code đó làm.

Như Steve đã chỉ ra rằng, đây là một điểm khác biệt chính giữa lập trình viên junior and senior:

Ngày xưa, việc phải nhìn quá nhiều code một lúc thường vượt quá điểm ngưỡng chịu đựng về sự phức tạp của tôi, và khi tôi phải làm việc cùng nó thì tôi thường cố gắng rewrite nó hoặc ít ra thì tôi viết comment rất nhiều. Tuy nhiên, ngày nay tôi chỉ làm việc say mê qua nó mà không than phiền (nhiều). Khi tôi đã có một mục tiêu xác định trong tâm trí và một mẩu code phức tạp để viết, tôi dành thời gian của mình để làm nó hơn là cứ ngồi kể câu chuyện của mình về nó [bằng các comment].

Các lập trình viên junior dựa vào các comment để nói lên câu chuyện khi mà họ nên dựa vào code để nói lên câu chuyện đó. Các comment mang tính tường thuật; quan trọng theo cách của riêng chúng, nhưng không có cách nào có thể thay thế cốt truyện, đặc tính và các thiết lập được cả.

Có lẽ đó là một bí mật hơi bẩn thỉu của các comment trong code: để viết các comment tốt thì bạn phải là một tay viết tốt. Các comment không phải là code dành cho trình biên dịch, chúng là những từ để truyền đạt các ý tưởng với những người khác. Trong khi tôi (hầu như) rất yêu quý những đồng nghiệp lập trình viên của mình, nhưng tôi không thể nói rằng việc truyền đạt hiệu quả với người khác là thế mạnh của chúng ta. Tôi đã từng nhìn thấy những bức email dài tới 3 đoạn từ những lập trình viên trong nhóm của mình mà khiến tôi cảm thấy não mình tan chảy. Liệu đây có phải là những người mà chúng ta đang tin tưởng sẽ viết ra những dòng comment rõ ràng và dễ hiểu trong code của mình? Tôi nghĩ rằng có thể một số người trong chúng ta phải trở nên gắn chặt với điểm mạnh của mình hơn — đó là, viết cho trình biên dịch theo một cách rõ ràng nhất mà chúng ta có thể làm, và chỉ sử dụng comment khi đó là phương án cuối cùng.

Việc viết những comment trong code tốt và có ý nghĩa thường rất khó. Nó cũng khó như là nghệ thuật viết code vậy; thậm chí còn khó hơn là đằng khác. Như Sammy Larbi đã nói trong bài Common Excuses Used To Comment Code rằng: nếu bạn cảm thấy code của bạn quá phức tạp để có thể hiểu mà không có comment đi kèm, thì code của bạn có thể rất tồi. Hãy viết lại nó cho tới khi không cần chút comment nào nữa. Nếu bạn đã hoàn thành xong nỗ lực đó, nhưng bạn vẫn cảm thấy các comment là cần thiết, thì hãy bổ sung thêm các comment. Nhưng thật cẩn trọng.

Nguồn: bài viết được dịch từ blog Coding Horror