Viết code Python sạch theo chuẩn PEP 8

Bởi /

Code chạy được là chưa đủ — code cần dễ đọc để bảo trì. PEP 8 là hướng dẫn phong cách chính thức của Python, giúp code của bạn nhất quán và chuyên nghiệp.

PEP 8 là gì?

PEP 8 là tài liệu quy ước cách viết code Python: đặt tên, thụt lề, khoảng trắng, độ dài dòng… Tuân thủ nó giúp code của bạn giống với hàng triệu dòng code Python khác — ai đọc cũng thấy quen thuộc.

Quy tắc đặt tên

ten_bien = "..."          # snake_case cho biến, hàm
def tinh_tong(): ...      # snake_case cho hàm
class TaiKhoan: ...       # PascalCase cho class
HANG_SO = 100             # UPPER_CASE cho hằng số

Thụt lề và khoảng trắng

# Dùng 4 dấu cách (không dùng tab)
x = 1            # có khoảng trắng quanh toán tử
ham(a, b)        # khoảng trắng sau dấu phẩy
d = {"a": 1}     # sau dấu hai chấm trong dict

Độ dài dòng và import

  • Giới hạn dòng khoảng 79 ký tự (nhiều dự án dùng 88-100).
  • Import theo thứ tự: thư viện chuẩn, thư viện bên thứ ba, module của bạn.
  • Mỗi import một dòng.

Công cụ tự động

Bạn không cần nhớ hết PEP 8 — hãy để công cụ làm giúp:

  • black — tự định dạng code theo chuẩn.
  • flake8 / ruff — phát hiện lỗi phong cách.
  • isort — sắp xếp import.

Vì sao code sạch quan trọng?

Bạn đọc code nhiều hơn viết. Code sạch giúp bạn (và đồng đội) hiểu nhanh, ít lỗi, dễ mở rộng. Đầu tư vào thói quen này từ sớm sẽ trả lại nhiều lần về sau.

Lên đầu trang