Loading…

Giới thiệu Công cụ Định dạng TOML Trực tuyến

Các cấu hình `pyproject.toml`, `Cargo.toml` hoặc `poetry` lộn xộn? Dán TOML của bạn hoặc thả một tệp và công cụ định dạng của chúng tôi sẽ chuẩn hóa khoảng trắng, sắp xếp gọn gàng các mảng và bảng nội tuyến, đồng thời giữ cho các phần của bạn được cách đều một cách nhất quán. Lý tưởng cho Python, Rust, Go, các trình tạo trang tĩnh và bất kỳ dự án nào dựa vào TOML để cấu hình.

Tính Năng Chính của Trình Định Dạng TOML

  • **Công cụ làm đẹp một cú nhấp chuột** cho các tệp và đoạn mã cấu hình TOML
  • **Kích thước thụt lề có thể cấu hình** từ 1 đến 8 khoảng trắng thông qua thanh trượt *Kích thước Thụt lề*
  • **Chuyển đổi kiểu thụt lề** – lựa chọn giữa khoảng trắng hoặc tab để thụt lề
  • **Điều khiển Ngắt dòng / Độ dài Dòng** để giữ các mảng dài và bảng nội tuyến trong phạm vi chiều rộng cột đã chọn
  • Hỗ trợ các tệp `.toml` như `pyproject.toml`, `Cargo.toml`, `Pipfile.toml`, `poetry.toml` và nhiều hơn nữa
  • Trình phân tích cú pháp TOML dựa trên Prettier hiểu rõ ngày tháng, mảng, bảng lồng nhau và bảng nội tuyến
  • Định dạng ổn định, bất biến – chạy lại trên cùng một tệp sẽ không gây ra sự thay đổi định dạng
  • Sao chép kết quả định dạng chỉ với một cú nhấp chuột, sẵn sàng cho trình soạn thảo hoặc commit của bạn

🛠️ Cách Định Dạng Tệp TOML Trực Tuyến for toml-formatter

1

1. Dán hoặc Tải Lên TOML Của Bạn

📥 Dán TOML vào trình soạn thảo hoặc kéo và thả một tệp `.toml` như `pyproject.toml` hoặc `Cargo.toml`. Công cụ phân tích nội dung dưới dạng TOML, không phải INI/JSON chung.

2

2. Chọn Cài Đặt Thụt Lề & Ngắt Dòng

⚙️ Sử dụng thanh trượt **Kích thước Thụt lề** để chọn số khoảng trắng cho mỗi cấp thụt lề, và chuyển **Kiểu Thụt lề** sang tab nếu dự án của bạn ưa thích chúng. Điều chỉnh **Ngắt dòng / Độ dài Dòng** để kiểm soát khi nào các mảng dài hoặc bảng nội tuyến nên ngắt dòng (hoặc đặt thành `0` để vô hiệu hóa ngắt dòng).

3

3. Nhấp "Định Dạng"

🚀 Nhấn nút **Định dạng**. Trình định dạng sẽ sắp xếp lại các mảng, dọn dẹp khoảng trắng xung quanh `=` và dấu phẩy, chuẩn hóa khoảng cách bảng và áp dụng ngắt dòng nhất quán trong khi bảo toàn dữ liệu của bạn.

4

4. Xem Lại, Sao Chép hoặc Lưu

🔍 So sánh TOML gốc và đã định dạng. Khi bạn hài lòng, sao chép kết quả trở lại trình soạn thảo hoặc lưu nó dưới dạng tệp `.toml` mới trong dự án của bạn.

Thông Số Kỹ Thuật

Các Tính Năng TOML Được Hỗ Trợ

Trình định dạng được xây dựng cho các cấu hình dự án thực tế và hiểu các cấu trúc TOML hiện đại.

Tính năngHỗ trợVí dụ / Ghi chú
Bảng & bảng con✅ Đầy đủ[tool.poetry], [project], [database.replica]
Mảng✅ Đầy đủMảng nội tuyến và mảng của bảng
Bảng nội tuyến✅ Đầy đủmáy_chủ = { alpha = "10.0.0.1", beta = "10.0.0.2" }
Ngày tháng & thời gian✅ Đầy đủ2025-09-23T10:20:30Z và định dạng ngày tháng địa phương
Chú thích✅ Được giữ nguyên# chú thích được giữ gần các cài đặt mà chúng mô tả
Chuỗi đa dòng✅ Đầy đủChuỗi TOML ba dấu ngoặc kép cho các khối văn bản dài

Tùy chọn Định dạng (Ánh xạ tới Điều khiển Công cụ)

Các tùy chọn này được hiển thị trực tiếp trong giao diện người dùng và kết nối với plugin Prettier TOML cơ bản:

Tùy chọnĐiều khiển Giao diệnPhạm vi / Giá trịMặc định
Kích thước thụt lềThanh trượt Kích thước Thụt lề1–8 khoảng trắng2 khoảng trắng
Kiểu thụt lềChọn Kiểu Thụt lềKhoảng trắng / TabKhoảng trắng
Độ dài dòngNgắt dòng / Độ dài Dòng0–120 cột (0 = không ngắt dòng hiệu quả)80 cột
Kết thúc dòngKết thúc dòng (nội bộ)LF / CRLFLF trong đầu ra trình duyệt

Đầu vào & Giới hạn

Công cụ được tối ưu hóa cho các tệp TOML nhỏ đến trung bình thường thấy trong các kho ứng dụng.

Tham sốGiá trị / Hành viGhi chú
Phần mở rộng tệp.tomlBất kỳ tệp cấu hình dựa trên TOML
Loại MIMEapplication/toml, text/x-tomlĐược sử dụng để phát hiện tệp trong vùng thả
Kích thước tệp tối đa~5 MBCác tệp lớn hơn có thể chậm hơn và nên xử lý trong CI
Số ký tự tối đa≈ 2,000,000Giới hạn cứng trong thời gian chạy trình định dạng để tránh trình duyệt bị treo

Kiểm tra & Xử lý Lỗi

Nếu tệp của bạn không phải là TOML hợp lệ (ví dụ: thiếu `=` hoặc dấu ngoặc không khớp), trình định dạng thường sẽ trả về lỗi dễ đọc thay vì đầu ra được định dạng. Sửa dòng được chỉ định và chạy lại trình định dạng.

Lựa chọn Thay thế Dòng lệnh cho Định dạng TOML

Yêu thích kết quả và muốn cùng phong cách trong CI hoặc hook pre-commit? Đây là các tùy chọn thân thiện với CLI:

Đa nền tảng (Node.js / Prettier)

Cài đặt Prettier và plugin TOML

npm install --save-dev prettier prettier-plugin-toml

Thêm Prettier và trình phân tích cú pháp TOML vào dự án của bạn.

Định dạng tệp TOML với Prettier

npx prettier --parser toml --write pyproject.toml

Viết lại `pyproject.toml` tại chỗ bằng quy tắc TOML của Prettier.

Linux / macOS / Windows (Taplo CLI)

Định dạng TOML bằng Taplo

taplo fmt pyproject.toml

Một trình định dạng CLI phổ biến khác cho tệp TOML.

Kiểm tra định dạng trong CI

taplo fmt --check .

Làm hỏng bản dựng nếu tệp TOML không được định dạng đúng.

Sử dụng công cụ trực tuyến này để chỉnh sửa và thử nghiệm nhanh, sau đó áp dụng cùng phong cách với Prettier hoặc Taplo trong pipeline CI của bạn.

Các Trường hợp Sử dụng Định dạng TOML Thông dụng

Đóng gói Python (`pyproject.toml`)

Giữ siêu dữ liệu dự án Python và cấu hình công cụ sạch sẽ và dễ xem xét.

  • Căn chỉnh các phần `[project]`, `[tool.poetry]` và `[tool.black]`.
  • Chuẩn hóa mảng phụ thuộc và bộ chỉ định phiên bản.
  • Làm cho sự khác biệt cấu hình dễ đọc hơn trong pull request.
[project]
name = "my-app"
version = "0.1.0"

[tool.black]
line-length = 88
include = "\.(py|pyi)$"

Dự án Rust (`Cargo.toml`)

Sắp xếp gọn gàng bản kê khai gói Rust qua các không gian làm việc và microservice.

  • Giữ `[dependencies]` và `[dev-dependencies]` được sắp xếp và có khoảng cách nhất quán.
  • Chuẩn hóa các bảng nội tuyến được sử dụng cho các cờ tính năng phức tạp.
  • Tiêu chuẩn hóa định dạng trên nhiều crate trong một workspace.
[package]
name = "my-crate"
version = "0.1.0"
edition = "2021"

[dependencies]
serde = { version = "1.0", features = ["derive"] }
tokio = { version = "1", features = ["full"] }

Trang Tĩnh & Công Cụ (Hugo, Zola, v.v.)

Làm sạch TOML được sử dụng cho trình tạo trang tĩnh và các công cụ đa dạng.

  • Định dạng `config.toml` cho Hugo hoặc các trình tạo trang tĩnh khác.
  • Giữ các khối cấu hình đa ngôn ngữ dễ đọc.
  • Chuẩn hóa các danh sách dài như mục menu và phân loại.

❓ Frequently Asked Questions

❓Trình định dạng TOML là gì?

Một trình định dạng TOML tự động cấu trúc lại các tệp TOML của bạn để chúng tuân theo một phong cách nhất quán: nó sửa lề, căn chỉnh mảng và bảng nội tuyến, chuẩn hóa khoảng trắng quanh `=` và dấu phẩy, và bảo toàn dữ liệu trong khi làm cho nó dễ đọc và xem xét hơn.

📏Tôi nên chọn kích thước và kiểu thụt lề như thế nào?

Nếu nhóm của bạn không có sở thích cụ thể, **2 khoảng trắng** là mặc định tốt. Khớp với phong cách đã được sử dụng trong kho của bạn: nếu các tệp chủ yếu được thụt lề bằng khoảng trắng, hãy tiếp tục sử dụng khoảng trắng; nếu tab là tiêu chuẩn của nhóm, hãy chuyển **Kiểu Thụt lề** sang Tabs để các thay đổi mới phù hợp với mã hiện có.

🧪Trình định dạng có xác thực cú pháp TOML không?

Trình phân tích cơ bản sẽ từ chối TOML không hợp lệ (ví dụ: thiếu `=` hoặc dấu ngoặc không khớp). Trong trường hợp đó, công cụ hiển thị thông báo lỗi thay vì đầu ra được định dạng, vì vậy bạn có thể sửa vấn đề và thử lại.

🔁Việc chạy trình định dạng có thể thay đổi hành vi cấu hình của tôi không?

Trình định dạng được thiết kế để **bảo toàn ngữ nghĩa**: nó chỉ thay đổi khoảng trắng và bố cục, không phải khóa, giá trị hoặc cấu trúc bảng. Miễn là tệp gốc là TOML hợp lệ, ý nghĩa cấu hình của bạn sẽ giữ nguyên.

🔒Có an toàn khi định dạng các tệp cấu hình nhạy cảm không?

Như với bất kỳ công cụ trực tuyến nào, tránh dán các tài liệu cực kỳ nhạy cảm như bí mật sản xuất. Đối với các cấu hình bảo mật cao, hãy sử dụng trình định dạng TOML cục bộ (như Prettier hoặc Taplo) trong môi trường phát triển riêng tư của bạn.

Pro Tips

Best Practice

Giữ một `pyproject.toml` hoặc `Cargo.toml` được định dạng đẹp trong nhánh chính của bạn, sau đó áp dụng cùng phong cách trong CI bằng Prettier hoặc Taplo.

Best Practice

Định dạng TOML trước khi commit các thay đổi phụ thuộc hoặc cấu hình lớn để các diff Git của bạn tập trung vào **thay đổi thực tế**, không phải nhiễu khoảng trắng.

Best Practice

Khi tái cấu trúc cấu hình, hãy định dạng tệp trước, commit, sau đó thay đổi giá trị. Điều này giúp dễ dàng xem xét những gì thực sự thay đổi.

Best Practice

Sử dụng cùng **kích thước thụt lề** và **độ dài xuống dòng** trong tất cả các tệp TOML của bạn để việc di chuyển giữa các dự án và xem xét mã cảm thấy nhất quán.

Additional Resources

Đặc Tả TOML v1.0.0
Documentation
Plugin Prettier TOML
Documentation
Taplo – Bộ Công Cụ TOML
Documentation

Other Tools