评论

*此内容使用人工智能(Beta)翻译,可能包含错误。若要查看英文页面,请点按 此处

一个 评论 是 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]]]
]=]

待办评论

Roblox Studio 支持特殊的 TODO 评论。工作室加粗任何跟随 TODO (直到被空间格分开) 的文本:


-- TODO:完成下面的函数,以便它真正地做到它的名称所暗示的内容。
local function stopWorldFromBlowingUp()
end

使用 TODO 评论来跟踪和沟通代验证码中的问题。