루아우 주석

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]]]
]=]

선언 바로 앞에 블록 주석을 배치하면 스크립트 편집기에서 해당 주석을 마우스를 올렸을 때 문서 툴팁으로 표시합니다. 이는 typeof()와 같은 타입 표현식 내의 선언에도 적용됩니다. 자세한 내용은 자동 완성 기능을 참조하세요.

주석 지시어

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

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

린팅을 위해 Roblox Studio는 루아우 린터에서 다음 하위 집합의 경고 코드를 활성화합니다: 1, 2, 3, 6, 10, 11, 12, 13, 14, 15, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28.

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

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

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

할 일 주석

Roblox Studio는 특별한 TODO 주석을 지원합니다. 스튜디오는 TODO 다음의 모든 텍스트를 굵게 표시합니다 (공백으로 끊기기 전까지):

-- TODO: 아래의 함수를 완성하여 실제로 이름이 의미하는 바를 수행하도록 하세요.
local function stopWorldFromBlowingUp()
end

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