So sánh văn bản / Kiểm tra khác biệt

Diff checker là gì?

Diff checker so sánh hai đoạn văn bản hoặc code và làm nổi bật những gì được thêm, xóa hay sửa. Lập trình viên dùng diff liên tục: review code, gỡ lỗi khi cấu hình thay đổi, so sánh response của API, kiểm tra migration và hiểu rõ các chỉnh sửa trước khi commit.

Đọc diff là kỹ năng cốt lõi của lập trình viên. Nó giúp tách *thay đổi hành vi thật sự* khỏi việc định dạng lại vô hại và giúp bạn phát hiện một ký tự bị sửa trong khối 200 dòng. Khi đã quen nhịp xanh / đỏ / vàng, việc review code sẽ nhanh hơn nhiều.

Hai kiểu diff quan trọng nhất là *diff theo dòng* (dòng nào thay đổi) và *diff theo từ* hay *diff theo ký tự* (cái gì thay đổi bên trong một dòng). Một công cụ diff tốt cho bạn chuyển qua lại giữa hai kiểu, tùy bạn đang so sánh mã nguồn hay các đoạn văn.

Những điều bạn học được khi so sánh văn bản

• Diff theo dòng cho biết thay đổi xảy ra *ở đâu*. Diff theo từ và theo ký tự cho biết *cái gì* thay đổi bên trong một dòng.
• Khoảng trắng có thể mang ý nghĩa (Markdown, YAML, Python) hoặc vô hại (hầu hết code khác), nên hãy bật hoặc tắt tùy chọn bỏ qua khoảng trắng cho phù hợp.
• Một diff trông nhỏ vẫn có thể ảnh hưởng rất lớn nếu nó đổi một giá trị, điều kiện, route, biến môi trường hay feature flag.
• Khi hai khối lớn khác nhau nhiều, hãy sắp xếp hoặc chuẩn hóa chúng trước: so sánh hai đối tượng JSON chưa sắp xếp có thể tạo ra cả một bức tường khác biệt giả.

Cách so sánh hai văn bản từng bước

1. 1

   Dán hai phiên bản

   Đặt văn bản gốc ở bên trái và phiên bản mới ở bên phải. Code, JSON, văn xuôi, tệp cấu hình, gì cũng được.

2. 2

   Chọn diff theo dòng hoặc theo từ

   Dùng diff theo dòng cho mã nguồn hoặc dữ liệu có cấu trúc. Chuyển sang diff theo từ khi so sánh các đoạn văn, nơi cách dùng từ mới là điều quan trọng.

3. 3

   Bật tắt khoảng trắng và phân biệt hoa thường

   Bật *bỏ qua khoảng trắng* nếu bạn chỉ quan tâm đến thay đổi có ý nghĩa; bật *bỏ qua hoa thường* khi so sánh log hoặc văn bản mà chữ hoa, chữ thường không quan trọng.

4. 4

   Đọc kết quả có tô màu

   Nội dung bị xóa hiện màu đỏ ở bên trái; nội dung được thêm hiện màu xanh ở bên phải. Dòng bị sửa thường hiện thành một cặp, mỗi bên một dòng, đặt cạnh nhau.

5. 5

   Chỉnh sửa và lặp lại

   Sửa bên nào cũng được và xem diff cập nhật trực tiếp. Cách này rất hợp để soạn một bản patch gọn gàng trước khi mở pull request.

Tra cứu nhanh màu sắc và ký hiệu diff

Các quy ước mà diff checker của Coddy dùng, cũng giống git diff, GitHub và hầu hết các trình xem diff khác.

Ví dụ diff để thử

API_TIMEOUT=3000

API_TIMEOUT=30000

{  "id": 42,  "status": "draft",  "published": false}

{  "id": 42,  "status": "published",  "published": true}

function total(items) {  let sum = 0;  for (const i of items) sum += i.price;  return sum;}

function total(items) {  return items.reduce((sum, i) => sum + i.price, 0);}

@@ -1,4 +1,4 @@ function greet(name) {-  return 'Hi ' + name;+  return `Hi ${name}`; }

Những lỗi thường gặp khi đọc diff

• Bỏ qua khoảng trắng khi khoảng trắng có ý nghĩa: Markdown, YAML và Python đều phụ thuộc vào thụt lề.
• Chỉ review các dòng xanh (được thêm) và bỏ sót những dòng đỏ (bị xóa) quan trọng.
• Cho rằng diff gọn gàng chứng tỏ phiên bản mới là đúng. Diff chỉ cho thấy *cái gì đã thay đổi*, không cho biết *thay đổi đó có đúng không*.
• So sánh JSON đã rút gọn với code đã định dạng mà không chuẩn hóa một trong hai trước: dòng nào cũng sẽ khác nhau dù dữ liệu giống hệt.
• Tin vào diff hai khung cạnh nhau với tệp rất dài mà không tìm các từ khóa cụ thể. Hãy dùng cả hai cách: lướt qua trước, rồi Ctrl+F tìm trường bạn quan tâm.

Câu hỏi thường gặp về Diff Checker