Comment trong Python: ghi chú một dòng, nhiều dòng
Bài 5/11 · Chương 1
Bắt đầu với Python
- 6 phút
- Cơ bản
- Python 3.14
- Cập nhật
Trong bài này · 12
Comment trong Python là lời ghi chú bạn viết sau dấu # để người đọc hiểu code, còn Python bỏ qua nó khi chạy. Bạn ghi chú khi một dòng code có lý do không tự nói ra được, chẳng hạn vì sao hóa đơn bàn 3 trừ đi một món, để vài tháng sau mở lại vẫn hiểu.
Cần biết trước: chương trình Hello World.
Comment một dòng với dấu
Một dòng mở đầu bằng dấu # là comment (ghi chú). Python đọc thấy # thì bỏ qua phần từ đó tới hết dòng, nên bạn viết gì sau nó cũng được, kể cả tiếng Việt có dấu.
# Tính tiền bàn 3: cà phê sữa, bạc xỉu, trà đào
print("Tổng tiền:", 29000 + 32000 + 35000, "đ")KẾT QUẢ
Tổng tiền: 96000 đChương trình có hai dòng nhưng kết quả chỉ có một dòng: comment không được in, không được tính. Dấu + là phép cộng, bài toán tử số học dạy kỹ. Comment giống mẩu giấy nhớ dán bên lề sổ sách. Người đọc thấy nó, còn phép tính trong sổ thì không đổi.
Comment cuối dòng
Comment không bắt buộc đứng riêng một dòng. Bạn có thể đặt # ngay sau một dòng code, cách code hai dấu cách, để ghi chú riêng cho dòng đó:
print("Cà phê sữa", 29000) # giá đã gồm ly mang về
print("Bạc xỉu", 32000)KẾT QUẢ
Cà phê sữa 29000
Bạc xỉu 32000Python chạy phần code bên trái dấu # như bình thường và bỏ qua phần bên phải. Comment cuối dòng hợp với một lời giải thích ngắn. Lời giải thích dài hơn một dòng thì đặt thành comment riêng ở phía trên.
Comment nhiều dòng
Python không có cú pháp riêng cho comment nhiều dòng. Cách thường dùng là đặt dấu # ở đầu mỗi dòng ghi chú:
# Hóa đơn bàn 3, ngày 13/11
# Khách là học viên nên được giảm giá,
# phần giảm giá sẽ tính ở bước sau.
print("Tổng tiền:", 96000, "đ")KẾT QUẢ
Tổng tiền: 96000 đTrong VS Code, bạn bôi đen nhiều dòng rồi bấm Ctrl+/ (macOS: Command+/) để thêm hoặc bỏ dấu # ở đầu các dòng đã chọn cùng lúc.
Bạn sẽ gặp code dùng cặp ba dấu nháy """ bao quanh vài dòng chữ như một ghi chú dài. Đó thực ra là chuỗi ba nháy, một chuỗi viết được trên nhiều dòng: Python vẫn đọc và tạo ra chuỗi đó, chỉ là không dùng tới. Chuỗi ba nháy đặt ngay dưới dòng định nghĩa hàm có vai trò riêng gọi là docstring, nên ghi chú thường ngày cứ dùng #.
Tạm tắt một dòng code bằng
Khi đang thử, bạn hay muốn bỏ một dòng ra khỏi chương trình mà không xóa hẳn, để lát nữa bật lại. Thêm # vào đầu dòng đó là xong: dòng code biến thành comment.
print("Cà phê sữa", 29000)
# print("Sinh tố bơ", 45000)
print("Trà đào", 35000)KẾT QUẢ
Cà phê sữa 29000
Trà đào 35000Dòng sinh tố bơ vẫn nằm trong file nhưng không chạy. Đổi # print thành print rồi chạy lại: kết quả có thêm một dòng là Sinh tố bơ 45000, nằm giữa hai món kia.
Nên ghi chú điều gì
Comment tốt nói điều code không tự nói được: lý do, giới hạn, việc còn dang dở. Comment kể lại đúng việc dòng code làm thì chỉ làm file dài thêm, và dễ sai khi code đổi mà comment quên đổi theo.
# Thừa: comment kể lại dòng code
print("Trà đào", 35000) # in chữ Trà đào và số 35000
# Có ích: comment nói lý do
print("Trà đào", 35000) # giá mới, áp dụng từ tháng 11KẾT QUẢ
Trà đào 35000
Trà đào 35000Hai lời gọi print() giống hệt nhau. Chỉ comment thứ hai cho người đọc biết điều họ không đoán được từ code: giá này có từ khi nào. Quy ước trình bày comment cho cả nhóm cùng theo nằm ở bài PEP 8 và Ruff.
Kiểm tra nhanh
print("Huế") # thành phố của Hàin ra gì?HuếHuế # thành phố của Hà- Báo lỗi vì có chữ sau dấu
#
print("Phòng #3")in ra gì?Phòng- Không in gì
Phòng #3
Những dòng nào Python bỏ qua hoàn toàn khi chạy?
# print("Bạc xỉu", 32000)print("Bạc xỉu", 32000) # món thứ hai# Hóa đơn bàn 3// print("Bạc xỉu", 32000)
Dòng
print("Cà phê sữa", 29000)cần một comment. Comment nào có ích cho người đọc hơn?# in chữ Cà phê sữa và số 29000# giá đã gồm ly mang về# in ra màn hình
Tóm tắt
Dấu
#mở một comment: Python bỏ qua phần từ#tới hết dòng.Comment cuối dòng đứng sau code, phần code bên trái vẫn chạy.
Dấu
#nằm trong cặp dấu nháy là ký tự của chuỗi và được in ra.Ghi chú nhiều dòng thì đặt
#ở đầu mỗi dòng.Thêm
#vào đầu một dòng code để tạm tắt nó mà không xóa;//gây lỗi cú pháp.Comment có ích nói lý do, không kể lại việc dòng code làm.
Câu hỏi thường gặp
Comment nhiều dòng trong Python viết thế nào cho nhanh?
Bôi đen các dòng cần ghi chú hoặc cần tắt, rồi bấm Ctrl+/ (macOS: Command+/) trong VS Code. Trình soạn thảo thêm dấu # vào đầu từng dòng, bấm lần nữa thì bỏ đi. Kết quả giống hệt việc bạn tự gõ # ở mỗi dòng.
Ghi chú trong Python có làm chương trình chạy chậm hơn không?
Không. Python bỏ qua comment ngay lúc đọc file, trước khi chạy dòng code nào. Một file có nhiều comment chạy nhanh như cùng file đó khi xóa hết comment.
Dùng chuỗi ba nháy làm comment nhiều dòng có giống dấu # không?
Không hẳn. Dấu # là comment thật, còn chuỗi ba nháy là một chuỗi Python vẫn tạo ra. Chuỗi ba nháy chỉ có vai trò riêng khi làm docstring của hàm, chủ đề của bài docstring trong Python.
Có nên comment mọi dòng code không?
Không nên. Code đặt tên rõ ràng thì tự nói được nó làm gì. Bạn để dành comment cho lý do, cho giới hạn và cho việc còn phải làm. Tên rõ ràng bắt đầu từ cách đặt tên biến.
Chủ đề
Bài này có hữu ích?
Hỏi đáp
Tham vấn chuyên môn
Nhà sáng lập AIDev và VietPlatform · Thạc sĩ AI MSE
- Tốt nghiệp thủ khoa xuất sắc Thạc sĩ AI MSE.
- Đồng sáng lập, CTO E-University, SVOnline: số hóa 10+ đại học, 40.000+ sinh viên.
- Xây hệ thống AI cho doanh nghiệp tại VietPlatform.