Luau 주석

A comment is text that the Luau parser ignores at runtime.

한 줄 주석

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

인라인 메모를 위해 한 줄 주석을 사용하세요. 주석이 여러 줄에 걸쳐 있으면 여러 개의 한 줄 주석을 사용하세요.

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

-- 이 조건은 정말 중요합니다. 누락되면 세상이 폭발할 것입니다.
if not foo then
	stopWorldFromBlowingUp()
end

블록 주석

두 개의 하이픈과 두 개의 괄호(--[[]])로 다중 줄 블록 주석을 정의할 수 있습니다. 항목을 문서화할 때 블록 주석을 사용하세요:

• 파일의 맨 위에 블록 주석을 사용하여 그 목적을 설명하세요.
• 함수나 객체 앞에 블록 주석을 사용하여 의도를 설명하세요.

--[[
    우주 달 레이를 즉시 끕니다.

    자정 산 표준 시간(또는 그 이후 15분 이내) 내에서만 호출해야 하며, 그렇지 않으면 우주 달 레이가 손상될 수 있습니다.
]]
local function stopCosmicMoonRay()
end

필요한 경우, 동일한 개수의 등호를 사용하여 블록 주석 내부에 여러 괄호를 중첩할 수 있습니다:

--[=[
    우주 달 레이에 대한 상세 세부 정보: [[[TOP SECRET]]]
]=]

주석 지시어

Luau는 !로 시작하는 주석을 사용하여 타입 검사, 네이티브 코드 생성, 및 린팅과 같은 기능을 제어합니다.

--!strict
--!nonstrict
--!nocheck
--!native
--!nolint
--!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, 28를 활성화합니다.

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

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

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

할 일 주석

Roblox Studio는 특별한 TODO 주석을 지원합니다. Studio는 TODO 다음의 모든 텍스트를 두껍게 표시합니다(공백으로 끊어질 때까지):

-- TODO: 아래의 함수를 완성하여 실제로 그 이름이 의미하는 바를 수행하게 합니다.
local function stopWorldFromBlowingUp()
end

TODO 주석을 사용하여 코드 내의 문제를 추적하고 소통하세요.