Bỏ qua đến nội dung chính
Mục lục

Comment trong Python: ghi chú một dòng, nhiều dòng

AIDev Team · duyệt: Nguyễn Việt Chung

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

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.

python
# 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 đó:

python
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 32000

Python 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ú:

python
# 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.

python
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 35000

Dò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.

python
# 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 11

KẾT QUẢ

Trà đào 35000
Trà đào 35000

Hai 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

  1. 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 #
  2. print("Phòng #3") in ra gì?

    • Phòng
    • Không in gì
    • Phòng #3
  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)
  4. 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
Đúng hết lần đầu +15 XP

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ủ đề

comment trong python

Bài này có hữu ích?

Hỏi đáp

Đang tải câu hỏi…

Tham vấn chuyên môn

Nguyễn Việt Chung

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.
Biên soạn: AIDev Team · Rà soát · Quy trình biên tập