ความคิดเห็นของ Luau

A comment คือข้อความที่ตัวประมวลผล Luau จะไม่สนใจในระหว่างการทำงาน

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

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

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

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

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

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

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

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

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

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

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

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

หากคุณวางความคิดเห็นแบบบล็อกทันทีที่ก่อนการประกาศ Script Editor จะแสดงความคิดเห็นเป็นเครื่องมือช่วยเอกสารเมื่อชี้เมาส์ไปที่มัน ซึ่งยังใช้ได้กับการประกาศภายในนิพจน์ประเภทเช่น typeof(). ดู ฟีเจอร์การเติมอัตโนมัติ สำหรับรายละเอียด

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

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 testing)
• 2 เปิดใช้งานการปรับแต่งเพิ่มเติม (ค่าเริ่มต้นในเกมสด)

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

ความคิดเห็นที่ต้องทำ

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

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

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