Clean Code là gì

01 Clean code theo các bậc thầy

Tác giả hỏi nhiều lập trình viên kỳ cựu "code sạch là gì?". Mỗi người một góc nhìn, nhưng các ý gặp nhau ở: đơn giản, lộ ý định, không trùng lặp, làm một việc.

02 Cái giá của một mớ hỗn độn

Ai cũng từng nhìn đống bừa mình vừa tạo ra rồi tự nhủ "để hôm khác dọn". Nhưng có một định luật phũ phàng — Định luật LeBlanc (LeBlanc's Law): Later equals never (để sau = không bao giờ). Khi code rối lên, mỗi thay đổi lại làm hỏng vài chỗ khác; không thay đổi nào còn là chuyện nhỏ.

Vòng xoáy "thêm người"

03 "Grand Redesign in the Sky"

Đến lúc đội ngũ nổi loạn, đòi viết lại từ đầu. Câu chuyện kinh điển này gần như luôn diễn ra theo cùng một kịch bản — và kết thúc cay đắng.

04 Nghịch lý & thái độ nghề nghiệp

Vì sao code tốt nhanh chóng mục thành code tồi? Ta hay đổ lỗi: yêu cầu đổi, lịch quá gấp, sếp dốt, marketing vô dụng… Nhưng — lỗi không nằm ở các vì sao, mà ở chính chúng ta.

Nghịch lý cơ bản (the primal conundrum)

Ai cũng biết mớ hỗn độn cũ làm mình chậm; vậy mà ai cũng chịu áp lực tạo mớ hỗn độn để kịp deadline. Người chuyên nghiệp thật sự biết vế sau là sai:

05 Quy tắc Hướng đạo (Boy Scout Rule)

Viết code tốt thôi chưa đủ — phải giữ nó sạch theo thời gian. Hội Hướng đạo Mỹ có một quy tắc đơn giản ta mượn được cho nghề:

Nghĩa là: mỗi lần check-in, để code sạch hơn một chút so với lúc check-out — thì code sẽ không thể nào mục đi. Việc dọn không cần lớn; chương sách gợi ý đúng bốn việc nhỏ:

Một lần dọn trại, gói gọn cả bốn việc

RAG  Trong hệ Hỏi–đáp tài liệu, đoạn lọc chunk theo độ liên quan là nơi quen "để sau dọn". Áp đúng bốn việc nhỏ ở trên cho một lần check-in:

def proc(d):                 # tên mơ hồ
    r = []
    for x in d:               # gộp nhiều việc, ngưỡng 0.7 lặp lại
        if x["s"] != None and x["s"] >= 0.7 and x["s"] <= 1:
            r.append(x)
    return r

RELEVANCE_THRESHOLD = 0.7    # hằng có tên

def keep_relevant(chunks):   # tên rõ; hàm nhỏ
    return [c for c in chunks if is_relevant(c)]

def is_relevant(chunk):      # điều kiện phức → 1 hàm tự kể ý
    return RELEVANCE_THRESHOLD <= chunk.score <= 1

06 Ghi nhớ nhanh