Commands you will use

Đây là bản đồ CLI thực hành cho tuần đầu làm việc với Faber. Hãy dùng trang này làm mục lục lệnh, sau đó mở trang chi tiết công cụ build Faber khi cần xem các cờ lệnh và thông tin chi tiết về pipeline biên dịch.

Vòng lặp hằng ngày#

Hãy bắt đầu với check. Đây là lệnh có chi phí thấp nhất và là lệnh mà các agent nên chạy trước khi đề xuất mã được sinh ra là Faber hợp lệ.

Kiểm tra#

faber check .
faber check examples/ai-workbench/packages/faber-ai

Một lần kiểm tra thành công có nghĩa là package được chấp nhận về cú pháp và ngữ nghĩa bởi phần đầu của trình biên dịch. Điều đó không có nghĩa là toolchain native cuối cùng đã được gọi.

Biên dịch#

faber build . -t rust

Đích Rust được thiết kế để dễ xem xét. Rust được sinh ra là một artifact của trình biên dịch, không phải nguồn sự thật; hãy chỉnh sửa package Faber rồi build lại thay vì tự sửa Rust đã xuất bằng tay.

Chạy#

faber run .

Dùng run cho các package ứng dụng có điểm vào bắt_đầu. Các package chỉ chứa thư viện nên được kiểm tra và chạy kiểm thử thay thế.

Giải thích chẩn đoán#

faber explain SEM001
faber explain LEX006

Các nhóm chẩn đoán là các mã tham chiếu ổn định: LEX cho lỗi từ vựng, PAR cho lỗi phân tích cú pháp, SEM cho lỗi ngữ nghĩa/kiểu. Trong tài liệu và báo cáo của agent, hãy trích dẫn mã chẩn đoán thay vì diễn giải mơ hồ về lỗi của trình biên dịch.

Lệnh theo locale người đọc#

faber format --reader-locale=la path/to/file.fab
faber format --reader-locale=th-TH path/to/file.fab
faber emit -t faber --reader-locale=zh-Hans path/to/file.fab

Đầu ra theo locale người đọc là cách biểu diễn mô hình ngữ nghĩa của trình biên dịch, không phải lớp dịch tại thời điểm trình duyệt chạy. Công việc locale nên được thực hiện sau khi package kiểm tra thành công ở dạng chuẩn.

Tiếp theo#