Công cụ định dạng Python (Ruff)

Định dạng Python là gì?

Công cụ định dạng Python chạy Ruff formatter – công cụ định dạng Python nhanh, tương thích Black – ngay trong trình duyệt qua WebAssembly. Nó chuẩn hóa thụt lề, khoảng cách, dấu nháy, dòng trống và ngắt dòng ở 88 ký tự.

Cách sử dụng Định dạng Python

1. Dán mã Python vào ô nhập hoặc bấm Tải ví dụ.
2. Chọn Thụt lề và Kiểu dấu nháy.
3. Bấm Định dạng. Lần chạy đầu tiên sẽ tải engine Ruff (WebAssembly, vài MB); các lần sau chạy tức thì.
4. Sao chép hoặc tải xuống mã đã định dạng.

Ví dụ

def f(a,b):
  return {'x':a}

def f(a, b):
    return {"x": a}

Khi nào nên dùng Định dạng Python

Dùng để làm gọn script và đoạn mã, định dạng mã cho câu trả lời hoặc giảng dạy, hoặc kiểm tra mã có phân tích được không. Công cụ chỉ định dạng – không áp dụng các sửa lỗi lint như xóa import không dùng hay sắp xếp import. Với dự án, hãy chạy ruff format hoặc Black trên máy với cấu hình của bạn.

Định dạng Python hoạt động như thế nào

Bản build chính thức @astral-sh/ruff-wasm-web của Ruff được tải khi cần. Một workspace Ruff được tạo với line-length = 88, indent-width / indent-style và quote-style đã chọn, rồi hàm format của nó được gọi. Ruff phân tích mã thành cây cú pháp và in ra theo phong cách Black (ví dụ hai dòng trống giữa các định nghĩa cấp cao nhất và magic trailing comma). Nếu không phân tích được mã, lỗi của Ruff được hiển thị kèm dòng và cột.

Các Trường Hợp Sử Dụng Phổ Biến

• ✓ Định dạng mã Jupyter hoặc script trước khi chia sẻ
• ✓ Làm cho mã từ các bài hướng dẫn tuân theo PEP 8
• ✓ Kiểm tra cú pháp Python mà không cần cài đặt gì
• ✓ Chuyển thụt lề từ 2 sang 4 dấu cách

Câu Hỏi Thường Gặp

Khám phá thêm danh mục