脚本编辑器

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

Studio 中的 脚本编辑器 是 Roblox 上的脚本编程主要工具。它是一个自我改进的环境,可以帮助您写代验证码,缩短您的开发时间,并在您的体验上循环。它可以通过以下方式改善您的脚本体验:

脚本编辑器支持所有类型的脚本,并且在您创建新脚本或在 Explorer 窗口中双击现有脚本时自动打开。

自动完成功效

脚本编辑器的自动完成功效会生成与编程有关的代码相关信息,例如:

  • 在告知提示上如何完成与体验数据模型有关的建议。例如,如果您有一个 Class.Model 在 Model 称为 1> 火箭飞船1>,自动完成建议 <

    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

脚本功能过滤器

脚本功能过滤器 显示脚本中所有函数的列表。要打开它,请按 AltF 在 Windows 上或 0> ⌥0> 2> F2> 在 Mac 上按钮。当列表打开时,您可以按一下每个函数的签名,过滤通过它们的名称,然后双击其中一个进

Script Function Filter showing all functions inside a script

找到并替换

Find/Replace widget 允许您在打开脚本中找到和替换代码。 该 widget 支持匹配案例,匹配整个字符,并使用正确的表达进行搜索。 要打开它,请在 Windows 上按 Ctrl F 或在 Mac 上按 ⌘ 2> F2> 。

Find/Replace widget labeled

实时反馈

脚本分析

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

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

输出窗口

输出窗口, 可从视图选项卡访问, 显示从运行脚本, 来自Roblox引擎, 来自调用到print()和错误从调用到1> arn()1>。 对于配置它为您的工作流程, 请参阅4>输出窗口4>。

代码助手

代码助手 是一个建议您键入时将代码中的行或函数提示出来,帮助您更高效地输入代码并保持专注。 基于您的评论和代验证码上的上下文,建议将在两种方式触发:

  • 自动 当您暂停在一条线上几秒钟,AI 模型有足够的上下文可以提出建议。
  • 手动 使用快捷方式 Alt 在 Windows 上或 在 Mac (您可以2> 自定义2> 此快捷方式)。

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

改进建议

为了获得更准确和相关的建议,建议您不要关注帮助,无论是否跟随清洁的编码实践:

  • 将您的代码拆解为更小的函数。
  • 使用描述性脚本名称,捕捉每个脚本的整体意图。例如,名称一个脚本 SyncCustomSounds 而不是只有 Sounds
  • 为参数、函数和脚本分配描述性名称。例如,名称一个部分 绿色球体 而不是简单地 grs ,或命名一个函数 generateSphere() 而不是 1> gen1>。使用命名函数与匿名函数可以生成更好的提示。
  • 包含一致的 评论 描述您正在实现的任务和输入/输出应该是什么。
    • 考虑在评论中包含一些预期结果的示例调用。
    • 提出解决问题的方法,例如 -- Use raycast
    • 使用您定义的函数或变量名,例如 -- Create 10 greenSphere objects 而不是 -- Create 10 spheres
  • 如果您是新手编程者,请从“制作玩家触摸零件”或使用工具生成小型代码片段,随着您的知识增长而扩展。

限制

该工具可以自动化基础编程任务,但它不总会推荐完美验证码。知道的限制包括:

  • 手动触发不会强制生成建议。
  • 建议是从代码集合中机器学习的,因此它们可以反映一些代码在训练上使用的限制。例如,建议可能不会使用最新的 API 而是使用更旧的 API,或者使用 Lua 而不是 Luau
  • 该工具可能会生成不相关或不清晰的信息,这可能不会对您有用。
  • 内部过滤器尝试阻止攻击语言,但它们不是全面的,也可能生成错误或歪曲的信息。
  • 建议可能会在用户之间相同或类似或不同,即使是相同的提示。但是,您的验证码永远不会与其他人分享。
  • 建议可能是不完整的,因为学习模型的输出长度有限。
  • 每天有一个数量限制,建议数量一旦达到上限,就会在第二天获得无建议。

代码隐私

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

此外,所有建议都是由AI模型生成 通过 模型训练,并且不会从一个用户转移到另一个用户。因为您的代码不是用于模型训练的,因此,您不会被建议使用 代码助手 的其他用户,除了发布到免费市场物品上的代码。

多重指针

脚本编辑器支持多个鼠标指针来同时进行编辑。您可以根据需要添加鼠标指针基于您的需快捷键。初始鼠标称为“主鼠标指针”,添加额外鼠标称为“副鼠标指针”。

  • 您在主鼠标副本上进行的编辑会反弹到主鼠标上的副本。每次编辑都会计为一个动作,所以编辑的撤销/重做适用于所有鼠标。
  • 自动完成 这样的 widget 会在主鼠标上,但不会在主鼠标上的副鼠标上。
  • 所有标准 键盘快捷方式 对脚本编辑工作,包括代码标记、切换评论和删除行。

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

命令窗户Mac
在鼠标位置添加/移除鼠标指针 Alt + 点按 + 点按
移除最近添加的鼠标 Ctrl U U
添加/修改鼠标拖动时的指针 Alt +拖动 +拖动
添加上方/下方的鼠标指针 Ctrl Alt / Ctrl 0>Alt0> 2>↓2> / 0> ⌥0> 2> ↓2>
添加鼠标至下一场匹配选择 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 上按下 ShiftAltL 或在 Mac 上按下 Shift1> ⌥1> 3> L3>。

移除鼠标

您可以使用以下键盘快捷键和鼠标手势来移除鼠标。或者,您可以按下 Esc 来退出多重编辑。

在鼠标位置

要移除鼠标指针:

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

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

最近添加

要移除最近添加的鼠标,请在 Windows 上按 CtrlU 或在 Mac 上按 2>U2>。

复制和粘贴曲标

复制代码中的一部分包括在其中的选项卡。 贴入的行为取决于源端的曲线器数量和目的地端的曲线器数量:

  • 如果数量相同,则各个复制的曲сор粘贴到各个相应的目标曲索。
  • 如果曲со器数量不同,那么目标上的每个曲со器都会收到所有复制的曲со器作为新行。

实时字体格式

按“输入/返回”会自动将每个鼠标指针关联到上一个线。如果上一个线开始于不完整的砖块,表格器将尝试完成它。

编辑器设置

许多自定义选项都可以通过 文件 > Studio 设置 (Windows 上的 Alt1> S1> 在 Mac 上) 访问。

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

常见的选项包括:

选项描述
字体 代码在编辑器的字体面和大小。
选项卡宽度 表示一个 Tab 增加的空间数。
使用空格进行折扣 如果启用,空格与 Tab 宽度 相等,按 Tab 按住插入。
文本包装 如果启用,更长的代码包围到下一行。
脚本编辑器颜色预设 对代码元素、选择颜色和更多进行颜色预设。选择一个预设后,您可以为选项设置特定颜色,例如 选择颜色评论颜色

键盘快捷键

脚本编辑器有以下键盘快捷键。您还可以从 Studio 工具栏中的 脚本 选项卡访问或编辑脚本。

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