脚本编辑器

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

Studio 中的 脚本编辑器 是 Roblox 上的脚本编写的主要工具。它是一个自我改进的环境,可以帮助你写出高影响力的代验证码、缩短开发时间并迭代你的经验。它可以通过以下方式提高您的脚本体验:

脚本编辑器支持所有类型的 脚本 并在创建新脚本或单击 资源管理器 窗口中的现有脚本时自动打开。

自动完成功能

脚本编辑器的自动完成功能生成与编程效率相关的信息,可以提高效率,例如:

  • 通知建议 在你输入句子时完成它们的上下文数据模型的方法。例如,如果你有一个 ModelWorkspace 被称为 火箭船 , 自动完成建议在你输入 RocketShip 时显示 workspace.roc 并指示它是一个 Model

    Autocomplete showing suggestions based on the experience's data model
  • 自动填充名称 对于你声明的变量和函数,可以帮助你避免烦人的拼写错误。

    Autocomplete showing suggestions based on a previously declared variable.
  • 带有代码示例的文档弹出窗口引擎 API 参考 相似,为您提供关于 API 使用的上下文。

    Autocomplete showing suggestions based on a Roblox Engine API.
  • 悬停工具提示 ,您可以自定义自己定义的文档。

    Autocomplete showing custom documentation.
  • 悬停脚本分析诊断 具有您可以使用来排除错误的信息。

    Autocomplete showing diagnostic information.
  • 函数签名 当你输入一个参数时,为你提供其参数和返回值的参考。

    Autocomplete showing function signature

代码导航

前往宣言

您可以在单击调用时按住 Ctrl 在 Windows 上或 在 Mac 上,或右击其调用并单击 跳转到宣言页

Go to Declaration workflow on a declared function

脚本功能过滤器

脚本功能过滤器 显示了脚本中所有声明的函数列表。要打开它,请在 Windows 上按 Alt F 或在 Mac 上按 F 。打开列表后,您可以浏览每个函数的签名,按名称过滤它们,然后单击其中一个以跳转到其宣言。

Script Function Filter showing all functions inside a script

查找并替换

查找/替换 widget 让你在打开的脚本中找到并替换代码。 widget支持匹配案例,匹配整个单词,以及按照正则搜索。要打开它,请在 Windows 上按 Ctrl F 或在 Mac 上按 F

Find/Replace widget labeled

实时反馈

脚本分析

从视图选项卡访问的脚本分析窗口,对您的脚本进行静态分析,并显示激活的错误和警告。了解有关错误和警告的更多信息,请参阅 Luau 检查 文档。

Script with various marked errors
脚本编辑器中突出的脚本错误
Script Analysis window with details on marked errors from script
错误在脚本分析窗口中解释

输出

视图 选项卡访问的输出窗口显示从运行脚本、从 Roblox 引擎收到的消息、从调用 print() 的错误以及从调用 warn()到错误。有关配置它为您的工作流程的详细信息,请参阅输出

代码助攻

代码助推 是一项功能,可以在你输入代码时建议线或函数的代码,帮助你更高效地编写代码并保持专注。基于你的评论和代验证码的上下文,建议将以两种方式触发:

  • 自动 当你暂停在几秒钟的线上时,AI模型有足够的上下文以进行建议。
  • 手动 使用快捷方式 Alt 在 Windows 上或 在 Mac 上(你可以 自定义 此快捷方式)。

Tab接受建议,或继续输入以忽略它目前,您的脚本需要包含至少几行代码才能触发建议。

改进建议

为了获得更准确和相关的建议,建议您遵循清洁编写代码的实践,无论是获得帮助,还是:

  • 将您的代码拆分为更小的函数。
  • 使用描述性脚本名称,捕捉每个脚本的整体意图。例如,命名一个脚本 SyncCustomSounds 而不是只有 声音
  • 为参数、函数和脚本分配描述性名称。例如,命名零件 绿色球 而不是简单地 grs , 或命名函数 generateSphere() 而不是 gen() 。使用命名函数与匿名函数也可以产生更好的提示。
  • 一致包含描述您正在实现的任务和输入/输出应该是什么的良好写作的 评论
    • 考虑在评论中包含一些示例调用与期望的结果。
    • 建议如何解决问题,例如 -- Use raycast .
    • 使用您定义的准确函数或变量名称,例如 -- Create 10 greenSphere objects 而不是 -- Create 10 spheres
  • 如果你是新手编程师,请开始使用基本项目,例如“当玩家触碰零件时让他们跳跃”或使用工具生成小代码片段,以便随着你的知识增长而扩展。

限制

该工具可以自动化基本编程任务,但并不总是建议完美验证码。已知限制包括:

  • 手动触发并不总是 强制 生成建议。
  • 建议是由一个代码库中的机器学习到的,因此它们可以反映一些代码上的限制。例如,建议可能不会使用更新的 API 来支持较旧的 API,或者可能会使用 Lua 而不是 Luau
  • 工具可能会生成不适合您目的的错误或误导性信息。
  • 内部过滤器试图阻止攻击性语言,但它们并不全面,也许工具会生成攻击性或偏见的信息。
  • 建议可能会在用户之间相同、相似或不同,即使使用相同的提示。但是,您的验证码永远不会与其他人共享。
  • 建议可能由于学习模型的输出长度有限而不完整。
  • 每天对建议数量有限制,一旦达到限制,你将在第二天之前没有建议。

代码隐私

目前,Roblox不使用任何非公共数据来训练学习模型。工具仅使用小子集的免费市场资产进行大语言模型调优,子集已通过各种质量和安全过滤进行检查。

此外,所有建议都由 AI模型 生成,不会从一个用户转移到另一个用户。由于您的代码不用于模型训练,因此不会建议其他用户使用 代码助推 ,只有一个例外是代码发布到免费市场物品。

多重指针

脚本编辑器支持使用多个鼠标同时进行编辑。您可以通过鼠标单击或键盘快捷键添加基于需求的鼠标指针。初始鼠标被称为 主鼠标 ,额外的鼠标被称为 次要鼠标

  • 编辑您在主鼠标复制到次要鼠标的编辑。每次编辑都计为一个动作,因此编辑的撤销/重做适用于所有的鼠标。
  • Widgets 例如 自动完成 出现在主鼠标上,但不是在次要鼠标上。
  • 所有标准 脚本编辑快捷键 用于脚本编辑工作都支持多重鼠标编辑,包括代码indentation、切换评论和删除行。

下表总结了多个鼠标工作流和其快捷方式。

命令窗口Mac
在鼠标位置添加/移除鼠标指针 Alt + 点按 + 点按
移除最近添加的鼠标 Ctrl U U
在鼠标拖动时添加/修改鼠标指针 Alt 拖动 拖动
在上方/下方添加鼠标 Ctrl Alt  / Ctrl Alt  /
将鼠标添加到下一匹配选择 Ctrl D D
将鼠标添加到每个匹配的选择 Shift Alt LShift L
选择栏/块 Shift Alt 拖动Shift 拖动
将选择分为线条 Shift Alt IShift I

添加鼠标

您可以通过键盘快捷键和鼠标操作的组合添加鼠标指针。如果它们占用相同的空间,例如添加箭头键的鼠标或删除箭头之间的所有字符,它们将合并。

在鼠标位置

要在鼠标指针位置添加鼠标指针:

  1. 在 Windows 上按住 Alt 或在 Mac 上按住

  2. 单击您想添加鼠标的位置。

通过拖动鼠标

您可以拖动鼠标以添加鼠标指针到选择、将多行选择拆分为单行或选择代码列和空白块。

要通过拖动添加鼠标到选择的代码:

  1. 在 Windows 上按住 Alt 或在 Mac 上按住

  2. 单击并拖动鼠标到代验证码选择上。

在主鼠标上方和下方

要直接在主鼠标上方或下方添加鼠标:

  1. 在 Windows 上按住 Ctrl Alt 或在 Mac 上按住

  2. 按下 箭头。

匹配选择

您可以将鼠标添加到选择的所有匹配项或下一场/前一场匹配项,并可选择是否匹配大/小写字母或匹配整个单词。

要将鼠标添加到选定部分的所有匹配项:

  1. 选择您想要搜索匹配的代码。

  2. 在 Windows 上按 Shift Alt L 或在 Mac 上按 Shift L

移除鼠标

您可以使用以下键盘快捷键和鼠标操作来移除鼠标指针。或者,您可以通过按Esc退出多重鼠标编辑。

在鼠标位置

要移除鼠标:

  1. 在 Windows 上按住 Alt 或在 Mac 上按住

  2. 单击你想要移除的鼠标。

最近添加的最多

要删除最近添加的鼠标,请在 Windows 上按 Ctrl U 或在 Mac 上按 U

复制并粘贴鼠标

复制选择代码包括其中的鼠标。粘贴的行为取决于来源中的鼠标数量和目标中的鼠标数量:

  • 如果鼠标数量相同,则每个复制的鼠标粘贴到对应的目标鼠标。
  • 如果鼠标数量不同,那么目标位置的每个鼠标都会收到每个复制的鼠标作为新行的整个粘贴内容。

在类型上的格式化

按下 Enter/Return 将自动在新行对上一行相对的每个鼠标进行indent。如果前一行以不完整的砖块开始,格式器将尝试完成它。

编辑器设置

许多自定义选项可通过 文件 > 工作室设置 (AltS 在 Windows; S 在 Mac) 访问。

A close up view of the Studio Settings window with the Script Editor tab selected.

常见修改选项包括:

选项描述
字体 编辑器中代码的字体面和尺寸。
标签宽度 代表 Tab indent 的空间数量。
使用空格进行indent 如果启用,空格与 标签宽度 相等的空格将被插入,按 Tab 按住。
文本包装 如果启用,更长的代码将包裹到下一行。
脚本编辑器颜色预设 对代码元素、选择颜色等的颜色预设。选择预设之后,您可以为选项设置特定颜色,例如 选择颜色评论颜色

键盘快捷键

脚本编辑器具有以下键盘快捷键。您还可以从 脚本 选项卡访问许多命令,每当您查看或编辑脚本时, Studio 工具栏都会显示。

命令窗口Mac
关闭脚本 Ctrl W W
重新打开最后关闭的脚本 Ctrl Shift T Shift T
快速打开 Ctrl P P
在 Explorer 中显示脚本 Ctrl Alt K K
放大 Ctrl = =
缩放出 Ctrl - -
重置脚本缩放 Ctrl 0 0