Đếm dòng code online: tách dòng trống, dòng chú thích và đo độ dài dòng
Công cụ đếm số dòng của đoạn code hoặc văn bản bạn dán vào, tách riêng bảy chỉ số gồm tổng dòng, dòng có nội dung, dòng trống, dòng code, dòng chú thích, dòng dài nhất và độ dài trung bình mỗi dòng. Thống kê cập nhật ngay khi bạn gõ, không cần bấm nút và không gửi code đi đâu.
Tính năng nổi bật
- Đếm tổng số dòng theo đúng số ký tự xuống dòng trong đoạn văn bản
- Tách riêng dòng có nội dung và dòng trống, dòng chỉ chứa dấu cách vẫn tính là trống
- Đếm dòng chú thích theo ba ký hiệu mở đầu phổ biến là hai gạch chéo, dấu thăng và gạch chéo kèm dấu sao
- Đếm dòng code là phần còn lại sau khi loại dòng trống và dòng chú thích
- Đo độ dài dòng dài nhất tính theo số ký tự, hữu ích khi rà soát quy ước độ rộng
- Tính độ dài trung bình của các dòng có nội dung, đã làm tròn về số nguyên
- Cập nhật ngay khi gõ hoặc dán, không có nút tính và không có bước chờ
- Chạy trong trình duyệt, mã nguồn bạn dán vào không rời khỏi máy
Đếm dòng để làm gì trong công việc thật
Số dòng không đo được chất lượng, nhưng nó trả lời nhanh mấy câu hỏi rất thực tế. Một tệp bao nhiêu dòng thì đủ lớn để tách nhỏ. Một yêu cầu gộp mã bao nhiêu dòng thì nên chia làm hai lượt duyệt thay vì đọc một lần. Sau đợt tái cấu trúc, số dòng giảm bao nhiêu so với trước. Tỷ lệ chú thích trên code của tệp này có quá thấp không. Và khi báo giá theo khối lượng cho một phần việc chuyển đổi hay dọn mã, con số dòng là cơ sở thô để ước lượng. Cái tiện của công cụ này so với cài trình đếm dòng trên máy là bạn dán một đoạn vào và có ngay bảy chỉ số, kể cả khi đoạn đó lấy từ một tin nhắn, một phản hồi API hay một tệp nhật ký chứ không phải một tệp trong dự án. Đổi lại, nó chỉ đếm những gì nằm trong ô nhập, không quét được cả thư mục.
Lợi ích khi sử dụng
- Biết ngay khối lượng một đoạn mã trước khi nhận việc hoặc trước khi duyệt
- So sánh nhanh số dòng trước và sau khi tái cấu trúc để thấy mức rút gọn thật
- Phát hiện tệp có dòng quá dài mà mắt thường khó nhận ra khi cuộn
- Không phải cài công cụ dòng lệnh chỉ để đếm một đoạn dán từ tin nhắn
- Mã nguồn nội bộ vẫn nằm trong máy vì không có bước tải lên
Cách đếm dòng của một đoạn code
- 1Mở tệp trong trình soạn thảo, chọn toàn bộ nội dung rồi sao chép.
- 2Dán vào ô nhập bên trái, nội dung dài vẫn cuộn được trong ô mà không cắt bớt.
- 3Đọc bảy chỉ số ở bảng thống kê bên phải, các con số đã tự cập nhật, không cần bấm nút nào.
- 4So dòng code với dòng chú thích để ước lượng mức tài liệu hóa của tệp.
- 5Xem dòng dài nhất và độ dài trung bình, nếu vượt quy ước của nhóm thì đánh dấu tệp đó vào danh sách cần dọn.
Bảy chỉ số nghĩa là gì và tính theo quy tắc nào
Tổng số dòng là số phần thu được khi cắt văn bản tại mỗi ký tự xuống dòng. Vì cách cắt này, một ô hoàn toàn trống vẫn cho kết quả là một dòng, và một tệp kết thúc bằng ký tự xuống dòng sẽ được tính thêm một dòng rỗng ở cuối, đúng như cách nhiều trình soạn thảo hiển thị. Dòng có nội dung là những dòng còn lại gì đó sau khi cắt bỏ dấu cách và dấu tab ở hai đầu. Dòng trống là phần bù, nên một dòng chỉ chứa bốn dấu cách vẫn được tính là trống. Dòng chú thích là những dòng mà sau khi cắt khoảng trắng đầu dòng thì bắt đầu bằng hai dấu gạch chéo, dấu thăng, gạch chéo kèm dấu sao, hoặc chỉ một dấu sao. Dòng code là những dòng có nội dung và không rơi vào nhóm chú thích, nên tổng của dòng code và dòng chú thích luôn bằng số dòng có nội dung. Dòng dài nhất đếm theo số ký tự của dòng, tính cả khoảng trắng thụt đầu dòng. Độ dài trung bình lấy tổng độ dài các dòng có nội dung chia cho số dòng đó rồi làm tròn, nên dòng trống không kéo con số này xuống.
Cách nhận diện chú thích và những trường hợp nó đếm sai
Công cụ nhận diện chú thích bằng cách nhìn ký tự mở đầu dòng chứ không phân tích cú pháp ngôn ngữ, nên nó đúng với phần lớn mã viết theo quy ước thông thường và sai ở một số trường hợp biên. Hai gạch chéo phủ được JavaScript, TypeScript, Java, C, C++, C sharp, Go, Rust, Swift, Kotlin, PHP và Scala. Dấu thăng phủ Python, Ruby, Perl, Shell, YAML và các tệp cấu hình. Gạch chéo kèm dấu sao cùng dấu sao đơn phủ khối chú thích nhiều dòng theo kiểu C và khối tài liệu kiểu JSDoc hay Javadoc. Ba trường hợp đếm sai cần biết. Thứ nhất, một dòng vừa có code vừa có chú thích ở cuối sẽ được tính là dòng code, vì phần chú thích không đứng ở đầu dòng. Thứ hai, một chuỗi ký tự chứa hai gạch chéo mà lại nằm ở đầu dòng, ví dụ một địa chỉ mạng xuống dòng trong mảng, sẽ bị đếm nhầm thành chú thích. Thứ ba, dòng giữa một khối chú thích nhiều dòng mà không bắt đầu bằng dấu sao sẽ bị tính là dòng code. Với mã viết theo quy ước phổ biến, sai lệch thường chỉ vài phần trăm, đủ dùng để ước lượng nhưng không nên đưa vào chỗ cần con số chính xác tuyệt đối.
Độ dài dòng: vì sao mốc 80 và 120 ký tự vẫn được nhắc tới
Mốc 80 ký tự bắt nguồn từ thời màn hình dòng lệnh rộng đúng 80 cột, nhưng nó sống sót vì có lý do thực tế. Khi duyệt mã trong giao diện so sánh hai cột, mỗi cột chỉ còn khoảng một nửa bề rộng màn hình, dòng dài hơn sẽ bị ngắt hoặc phải cuộn ngang, và cuộn ngang khi đọc mã là thứ khiến người duyệt bỏ sót lỗi. Nhiều nhóm hiện nay nới lên 100 hoặc 120 ký tự cho vừa với màn hình rộng và với các ngôn ngữ có tên định danh dài. Cách đọc hai chỉ số của công cụ như sau: độ dài trung bình phản ánh phong cách chung của tệp, mức 40 đến 80 ký tự là bình thường, còn trên 100 là dấu hiệu tệp có nhiều biểu thức dài nên gộp nhiều việc vào một dòng. Dòng dài nhất phản ánh trường hợp cực đoan, một con số vài trăm ký tự thường là chuỗi mã hóa, một đường dẫn dài, một dòng đã bị nén, hoặc một chuỗi điều kiện nối liên tiếp cần tách ra. Hai chỉ số này nên đọc cùng nhau: trung bình thấp mà dòng dài nhất rất cao nghĩa là chỉ có vài chỗ cần dọn, còn cả hai đều cao là vấn đề phong cách của cả tệp.
Tỷ lệ chú thích trên code nói lên điều gì
Không có con số đúng cho mọi dự án, nhưng có vài mốc để đối chiếu. Mức chú thích chiếm khoảng 10 đến 25 phần trăm số dòng có nội dung là khoảng thường gặp ở mã ứng dụng thông thường. Thư viện dùng chung và mã có giao diện lập trình công khai thường cao hơn vì mỗi hàm công khai cần một khối tài liệu. Mã kiểm thử thường thấp hơn hẳn vì tên hàm kiểm thử đã mô tả hành vi. Điều quan trọng hơn con số là loại chú thích. Chú thích giải thích vì sao lại làm như vậy là loại có giá trị, vì thông tin đó không đọc ra được từ mã. Chú thích mô tả lại đúng những gì dòng bên dưới đang làm là loại vô ích và sẽ nhanh chóng lệch với mã khi có người sửa. Còn mã bị chú thích để tạm bỏ đi thì nên xóa hẳn, vì hệ thống quản lý phiên bản đã giữ lịch sử rồi; loại này lại đẩy con số chú thích lên cao và làm tỷ lệ trông đẹp một cách giả tạo. Vì thế khi thấy tỷ lệ chú thích rất cao, hãy mở tệp xem đó là tài liệu thật hay là mã chết bị bỏ lại.
Giới hạn của công cụ và lúc nào nên dùng công cụ khác
Công cụ đếm đúng những gì nằm trong ô nhập, nên có bốn giới hạn cần biết. Thứ nhất, nó không quét được cả thư mục hay kho mã; muốn có báo cáo cho toàn dự án theo từng ngôn ngữ, hãy dùng công cụ dòng lệnh chuyên đếm dòng mã nguồn, loại đó phân tích theo từng ngôn ngữ nên đếm chú thích chính xác hơn nhiều. Thứ hai, nó không phân biệt ngôn ngữ, nên đoạn Python và đoạn JavaScript được đếm bằng cùng một bộ quy tắc. Thứ ba, mọi thứ nằm trong bộ nhớ trình duyệt, dán tệp vài chục nghìn dòng vẫn chạy được nhưng trên trăm nghìn dòng thì giao diện bắt đầu giật vì ô nhập phải dựng lại toàn bộ nội dung mỗi lần thay đổi. Thứ tư, không có chức năng lưu, đóng tab là mất, nên hãy chép các con số ra chỗ khác nếu bạn cần đối chiếu về sau. Đổi lại, giới hạn cuối chính là ưu điểm về mặt bảo mật: không có bước tải lên nào nên mã nguồn thuộc sở hữu của công ty bạn không đi ra khỏi máy.
Câu hỏi thường gặp (FAQ)
Vì sao ô trống mà vẫn hiện tổng số dòng là 1?
Vì tổng số dòng được tính bằng cách cắt văn bản tại mỗi ký tự xuống dòng, và một chuỗi rỗng không có ký tự xuống dòng nào nên cho ra đúng một phần. Đây cũng là cách phần lớn trình soạn thảo đánh số dòng, tệp rỗng vẫn hiển thị dòng số 1.
Dòng chỉ có dấu cách được tính là dòng trống hay dòng có nội dung?
Tính là dòng trống. Công cụ cắt bỏ dấu cách và dấu tab ở hai đầu trước khi kiểm tra, nên một dòng chỉ chứa khoảng trắng sẽ rơi vào nhóm dòng trống. Cách tính này khớp với hầu hết công cụ đếm dòng mã nguồn khác.
Công cụ nhận diện chú thích của những ngôn ngữ nào?
Nó nhìn ký tự mở đầu dòng chứ không phân tích cú pháp. Hai gạch chéo phủ JavaScript, TypeScript, Java, C, C++, C sharp, Go, Rust, PHP và nhiều ngôn ngữ khác. Dấu thăng phủ Python, Ruby, Shell và YAML. Gạch chéo kèm dấu sao cùng dấu sao đơn phủ khối chú thích nhiều dòng kiểu C.
Dòng vừa có code vừa có chú thích ở cuối được tính vào đâu?
Tính là dòng code, vì phần chú thích không đứng ở đầu dòng. Đây là lựa chọn hợp lý trong đa số trường hợp vì dòng đó vẫn chứa mã chạy được. Nếu bạn cần con số chú thích chính xác tuyệt đối, hãy dùng công cụ có phân tích cú pháp riêng cho từng ngôn ngữ.
Vì sao số dòng chú thích của tôi thấp hơn thực tế?
Thường do các dòng nằm giữa một khối chú thích nhiều dòng nhưng không bắt đầu bằng dấu sao. Công cụ chỉ nhận diện theo ký tự mở đầu dòng nên những dòng đó bị xếp vào nhóm dòng code. Với mã viết theo quy ước có dấu sao đầu mỗi dòng thì kết quả khớp.
Tổng dòng code cộng dòng chú thích có bằng tổng số dòng không?
Không, mà bằng số dòng có nội dung. Tổng số dòng còn bao gồm cả dòng trống. Quan hệ đúng là tổng số dòng bằng dòng có nội dung cộng dòng trống, và dòng có nội dung bằng dòng code cộng dòng chú thích.
Độ dài trung bình có tính cả dòng trống không?
Không. Độ dài trung bình lấy tổng số ký tự của các dòng có nội dung chia cho số dòng có nội dung rồi làm tròn về số nguyên. Cách tính này tránh việc một tệp nhiều dòng trống bị kéo con số trung bình xuống thấp một cách vô nghĩa.
Độ dài dòng bao nhiêu là hợp lý?
Mốc truyền thống là 80 ký tự, nhiều nhóm hiện nay nới lên 100 hoặc 120 cho vừa màn hình rộng. Lý do thực tế là khi duyệt mã trong giao diện so sánh hai cột, dòng dài buộc phải cuộn ngang và đó là lúc người duyệt hay bỏ sót lỗi.
Tỷ lệ chú thích trên code bao nhiêu là đủ?
Khoảng 10 đến 25 phần trăm số dòng có nội dung là mức thường gặp ở mã ứng dụng. Thư viện dùng chung thường cao hơn, mã kiểm thử thường thấp hơn. Quan trọng hơn con số là loại chú thích: giải thích lý do thì có giá trị, mô tả lại đúng việc dòng bên dưới đang làm thì không.
Số dòng có phải thước đo năng suất lập trình viên không?
Không. Một trăm dòng gọn gàng có thể thay thế một nghìn dòng lặp đi lặp lại, và việc xóa bớt mã thường có giá trị hơn việc thêm mã. Số dòng chỉ nên dùng để ước lượng khối lượng và theo dõi xu hướng của một tệp hay một dự án, không dùng để so sánh giữa người với người.
Dán được đoạn dài bao nhiêu?
Vài chục nghìn dòng vẫn chạy mượt trên máy tính thông thường. Từ khoảng trăm nghìn dòng trở lên, giao diện bắt đầu giật vì ô nhập phải dựng lại toàn bộ nội dung mỗi lần thay đổi. Với dữ liệu lớn hơn nên dùng công cụ dòng lệnh trên máy.
Mã nguồn tôi dán vào có được gửi lên máy chủ không?
Không. Việc đếm chạy bằng JavaScript ngay trong trình duyệt, không có lời gọi mạng nào và cũng không có bước lưu trữ. Bạn dán được mã thuộc sở hữu của công ty mà không lo dữ liệu rời máy, đổi lại thì tải lại trang là mất, nên hãy chép các con số ra trước khi đóng tab.
Từ khóa liên quan
- đếm dòng code online
- công cụ đếm số dòng
- đếm dòng trong file text
- line counter online
- đếm dòng code miễn phí
- thống kê số dòng mã nguồn
- đếm dòng comment và dòng code
- lines of code là gì
- đo độ dài dòng code
- quy ước 80 ký tự một dòng
- tỷ lệ comment trên code
- đếm dòng python javascript
- đếm dòng trống trong văn bản
- ước lượng khối lượng code
- công cụ cloc thay thế online
- đếm dòng log file
- thống kê code không cần cài đặt
- kiểm tra file code quá dài
- đếm ký tự và dòng online
- công cụ cho lập trình viên miễn phí
