Luau 코멘트

A 주석 은 런타임에 Luau 파서가 무시하는 텍스트입니다.

단일 줄 주석

문자열 외부에서 두 개의 하이픈(--)으로 단일 줄 주석을 정의할 수 있습니다. 단일 줄 주석은 줄 끝까지 확장됩니다.

줄 단위 주석을 인라인 주석에 사용합니다. 주석이 여러 줄에 걸쳐 있는 경우 여러 줄의 단일 주석을 사용합니다.

스크립트 편집기에서 키보드 단축키 Ctrl/ ( ⌘/ )를 사용하여 단일 줄 주석을 추가하고 제거할 수 있습니다.

-- 이 조건은 매우 중요합니다, 왜냐하면 세상이 폭발할 것이기 때문입니다.
-- 없었습니다.
if not foo then
	stopWorldFromBlowingUp()
end

코멘트 차단

더블 하이픈과 더블 괄호로 여러 줄 블록 주석을 정의할 수 있습니다(--[[]]). 항목을 문서화하기 위해 블록 주석을 사용하십시오:

• 파일 상단에 블록 주석을 사용하여 목적을 설명합니다.
• 함수나 개체 앞에 블록 주석을 사용하여 의도를 설명합니다.

--[[
    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

필요한 경우 시작 및 끝 괄호에서 동일한 수의 평등 기호를 사용하여 블록 주석 내에 여러 괄호를 중첩할 수 있습니다:

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

주석 지시어

Luau는 ! 로 시작하는 주석을 사용하여 기능을 제어합니다, 형식 검사, 네이티브 코드 생성, 그리고 검사 .

--!스트릭트
--!nonstrict
--!노체크
--!네이티브
--!놀인트
--!optimize 0|1|2

검사를 위해 Roblox Studio는 Luau 검사기에서 다음 하위 집합의 경고 코드를 활성화합니다: 1, 2, 3, 6, 10, 11, 12, 13, 14, 15, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27

--!optimize 지시어는 스크립트의 Luau 컴파일러 최적화 수준을 제어합니다:

• 0은 최적화 비활성화.
• 1은 기본 최적화(Studio 테스트에서 기본)를 활성화합니다.
• 2는 추가 최적화를 가능하게 하며(라이브 게임에서 기본값)

정확한 최적화는 게시되지 않으며 변경될 수 있습니다. 특정 이유가 없는 한 기본값을 사용하는 것이 좋습니다.

해야 할 코멘트

Roblox Studio는 특별한 TODO 주석을 지원합니다. Studio는 공백으로 나뉘기 전까지 모든 텍스트를 대괄호로 강조 표시합니다(TODO):

-- TODO: 아래 함수를 완료하여 이름이 암시하는 바대로 실제로 수행합니다.
local function stopWorldFromBlowingUp()
end

TODO를 사용하여 코드 내의 문제를 추적하고 커뮤니케이션합니다.