Bình luận Luau

Một bình luận là văn bản mà Luau parser bỏ qua khi chạy thời gian thực .

Bình luận một dòng

Bạn có thể định nghĩa bình luận dòng đơn với một dấu gạch ngang đôi ( -- ) ở bất kỳ nơi nào bên ngoài một chuỗi. Bình luận dòng đơn mở rộng đến cuối dòng.

Sử dụng bình luận dòng đơn cho các ghi chú trong chuỗi. Nếu bình luận chiếm nhiều dòng, sử dụng nhiều bình luận dòng đơn.

Bạn có thể thêm và xóa bình luận một dòng trong Trình soạn thảo kịch bản với lối tắt bàn phím Ctrl/ ( ⌘/ ).

-- Điều kiện này thực sự quan trọng vì thế giới sẽ nổ tung nếu nó
-- đã bị thiếu.
if not foo then
	stopWorldFromBlowingUp()
end

Chặn bình luận

Bạn có thể định nghĩa bình luận khối nhiều dòng với dấu gạch chéo đôi và dấu ngoặc kép ( --[[]] ). Sử dụng bình luận khối để ghi lại các mục:

• Sử dụng bình luận khối ở đầu các tập tin để mô tả mục đích của chúng.
• Sử dụng bình luận khối trước các chức năng hoặc đối tượng để mô tả ý định của chúng.

--[[
    Shuts off the cosmic moon ray immediately.

    Should only be called within 15 minutes of midnight Mountain Standard
    Time, or the cosmic moon ray may be damaged.
]]
local function stopCosmicMoonRay()
end

Nếu cần thiết, bạn có thể lồng nhiều dấu ngoặc trong một phần bình luận khối bằng cách sử dụng cùng số dấu bằng nhau ở cả phần đầu và phần cuối của dấu ngoặc:

--[=[
    In-depth detail about cosmic moon ray: [[[TOP SECRET]]]
]=]

Nhận xét các lệnh

Luau sử dụng các bình luận bắt đầu với ! để kiểm soát các tính năng như kiểm tra loại , tạo mã bản địa và linting .

--!nghiêm ngặt
--!không nghiêm ngặt
--!không kiểm tra
--!bản địa
--!không nói gì
--!optimize 0|1|2

Đối với kiểm tra, Roblox Studio bật kích hoạt các phần sau của mã cảnh báo từ Luau linter : 1, 2, 3, 6, 10, 11, 12, 13, 14, 15, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28.

Các định hướng --!optimize trực tiếp kiểm soát cấp độ tối ưu hóa của người biên dịch Luau cho kịch bản:

• 0 tắt bỏ tối ưu hóa.
• 1 bật các tối ưu cơ bản (mặc định trong thử nghiệm Studio).
• 2 cho phép tối ưu hóa thêm (mặc định trong các trò chơi trực tiếp).

Việc tối ưu hóa chính xác không được công bố và chịu sự thay đổi. Chúng tôi khuyên bạn nên sử dụng các giá trị mặc định trừ khi bạn có lý do cụ thể không làm như vậy.

Bình luận To-do

Roblox Studio hỗ trợ bình luận đặc biệt TODO . Studio in đậm bất kỳ văn bản nào sau TODO (cho đến khi bị phá vỡ bởi một khoảng trống):

-- TẤT CẢ: Hoàn thành chức năng bên dưới để nó thực sự làm những gì tên của nó đề cập.
local function stopWorldFromBlowingUp()
end

Sử dụng bình luận TODO để theo dõi và truyền đạt các vấn đề trong mã của bạn.