ความคิดเห็นใน Luau

A ความคิดเห็น คือข้อความที่ตัวประมวลผล Luau มองข้ามในช่วงเวลาการทำงาน

ความคิดเห็นแบบบรรทัดเดียว

คุณสามารถกำหนดความคิดเห็นแบบบรรทัดเดียวด้วยเครื่องหมายแดชคู่ (--) ได้ทุกที่ที่อยู่นอกสตริง ความคิดเห็นแบบบรรทัดเดียวจะยืดไปจนถึงจบบรรทัด

ใช้ความคิดเห็นแบบบรรทัดเดียวสำหรับหมายเหตุภายในบรรทัด หากความคิดเห็นมีหลายบรรทัด ให้ใช้ความคิดเห็นแบบบรรทัดเดียวหลายบรรทัด

คุณสามารถเพิ่มและลบความคิดเห็นแบบบรรทัดเดียวใน Script Editor ด้วยทางลัดคีย์บอร์ด Ctrl/ (⌘/)

-- เงื่อนไขนี้สำคัญมากเพราะโลกจะระเบิดขึ้นถ้ามัน
-- ขาดหายไป
if not foo then
	stopWorldFromBlowingUp()
end

ความคิดเห็นแบบบล็อก

คุณสามารถกำหนดความคิดเห็นแบบบล็อกหลายบรรทัดด้วยแดชคู่และวงเล็บคู่ (--[[]]) ใช้ความคิดเห็นแบบบล็อกสำหรับเอกสารสิ่งของ:

• ใช้ความคิดเห็นแบบบล็อกที่ด้านบนของไฟล์เพื่ออธิบายวัตถุประสงค์ของไฟล์
• ใช้ความคิดเห็นแบบบล็อกก่อนฟังก์ชั่นหรือวัตถุเพื่ออธิบายเจตนา

--[[
    ปิดเรย์ดวงจันทร์จักรวาลทันที

    ควรเรียกใช้ภายใน 15 นาทีของเที่ยงคืนเวลา Mountain Standard
    มิฉะนั้นเรย์ดวงจันทร์จักรวาลอาจเสียหาย
]]
local function stopCosmicMoonRay()
end

หากจำเป็น คุณสามารถซ้อนวงเล็บหลายชุดภายในความคิดเห็นแบบบล็อกโดยใช้จำนวนเครื่องหมายเท่ากันในทั้งวงเล็บเริ่มต้นและสิ้นสุด:

--[=[
    รายละเอียดเชิงลึกเกี่ยวกับเรย์ดวงจันทร์จักรวาล: [[[ความลับสุดยอด]]]
]=]

คำสั่งความคิดเห็น

Luau ใช้ความคิดเห็นที่เริ่มต้นด้วย ! เพื่อควบคุมฟีเจอร์ต่างๆ เช่น การตรวจสอบชนิดข้อมูล, การสร้างโค้ดที่เป็นเนทีฟ, และ การตรวจสอบคุณภาพโค้ด

--!strict
--!nonstrict
--!nocheck
--!native
--!nolint
--!optimize 0|1|2

สำหรับการตรวจสอบคุณภาพโค้ด Roblox Studio จะเปิดใช้งานชุดรหัสคำเตือนย่อยจาก Luau linter: 1, 2, 3, 6, 10, 11, 12, 13, 14, 15, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28

คำสั่ง --!optimize ควบคุมระดับการปรับแต่งของคอมไพเลอร์ Luau สำหรับสคริปต์:

• 0 ปิดการปรับแต่ง
• 1 เปิดการปรับแต่งพื้นฐาน (ค่าเริ่มต้นในการทดสอบใน Studio)
• 2 เปิดการปรับแต่งเพิ่มเติม (ค่าเริ่มต้นในเกมที่เล่นจริง)

การปรับแต่งที่แน่นอนจะไม่ถูกเผยแพร่และอาจมีการเปลี่ยนแปลง เราขอแนะนำให้ใช้ค่าที่เริ่มต้นเว้นแต่คุณจะมีเหตุผลเฉพาะในการไม่ใช้

ความคิดเห็นในการทำรายการ

Roblox Studio สนับสนุนความคิดเห็นพิเศษ TODO Studio จะทำให้ข้อความใดๆ ที่ตามหลัง TODO เป็นตัวหนา (จนกว่าจะถูกขัดจังหวะด้วยช่องว่าง):

-- TODO: เสร็จสิ้นฟังก์ชันด้านล่างเพื่อให้มันทำในสิ่งที่ชื่อของมันบ่งบอก
local function stopWorldFromBlowingUp()
end

ใช้ความคิดเห็น TODO เพื่อติดตามและสื่อสารปัญหาในโค้ดของคุณ