脚本编辑器

在 Studio 中的 脚本编辑器 是 Roblox 上脚本编写的主要工具。它是一个自我改进的环境，可以帮助您编写高影响力的代码，缩短开发时间，并对游戏进行迭代。它可以通过以下方式改善您的脚本体验：

• 格式化和高亮显示代码中的语法。
• 提供在您输入时 自动完成 短语的方式。
• 帮助您通过跳转到变量和函数声明来 导航代码。
• 帮助您在打开的脚本或所有脚本中 查找和替换 代码。
• 提供关于代码质量和性能的 实时反馈。

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

自动完成功能

脚本编辑器的自动完成功能生成与代码相关的信息，可以提高您的编程效率，例如：

• 有根据的建议，在您输入短语时提供与游戏的 数据模型 相关的上下文。例如，如果您在 Workspace 中有一个名为 RocketShip 的 Model，当您输入 workspace.roc 时，自动完成会建议 RocketShip，并指示它是一个 Model。

  

  使用 ↑ 和 ↓ 键浏览建议，然后按 Tab 或 Enter 接受建议并插入完整短语。

• 自动填充变量和函数的名称，帮助您避免恼人的拼写错误。

  

• 带有代码示例的文档弹出窗口，类似于 引擎 API 参考，为您提供 API 使用的上下文。

  

• 悬停工具提示，您可以使用自己定义的文档进行自定义。

  

• 悬停脚本分析诊断，提供您可以用来排除错误的信息。

  

• 函数签名，当您输入参数时，提供参数和返回值的参考。

  

代码导航

跳转到声明

您可以通过在点击调用时按住 Ctrl（Windows）或 ⌘（Mac）来跳转到函数或变量的声明，或者通过右键单击其调用并单击 跳转到声明。

脚本函数过滤器

脚本函数过滤器 显示脚本中声明的所有函数的列表。要打开它，请在 Windows 上按 AltF，或在 Mac 上按 ⌥F。打开列表后，您可以浏览每个函数的签名，通过名称进行过滤，并双击一个以跳转到其声明。

查找和替换

查找/替换 小部件允许您在打开的脚本中查找和替换代码。该小部件支持匹配大小写、匹配整个单词和通过正则表达式搜索。要打开它，请在 Windows 上按 CtrlF，或在 Mac 上按 ⌘F。

实时反馈

脚本分析

脚本分析 窗口可以通过 Studio 的 脚本 选项卡工具栏中的 分析 按钮访问，对您的脚本进行静态分析并显示活动错误和警告。有关错误和警告的更多信息，请参见 Luau linting 文档。

输出

输出 窗口显示从运行脚本中捕获的错误、来自 Roblox 引擎的消息、来自 print() 调用的消息以及来自 warn() 调用的错误。

代码助手

代码助手 是一项功能，可以在您输入时建议代码行或函数，帮助您更高效地编码并保持专注。根据您注释和代码中的上下文，建议将通过两种方式触发：

• 自动，当您在一行上暂停几秒钟并且 AI 模型有足够的上下文进行建议时。
• 手动，使用快捷键 Alt∖（Windows）或 ⌥∖（Mac）。

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

改善建议

为了获得更准确和相关的建议，建议您遵循清晰的编码实践，无论是否有帮助，并且：

• 将代码分解为更小的函数。
• 使用描述性的脚本名称，捕捉每个脚本的整体意图。例如，将脚本命名为 SyncCustomSounds 而不是仅仅 Sounds。
• 为参数、函数和脚本分配描述性名称。例如，将一个部件命名为 GreenSphere 而不是简单的 grs，或者将函数命名为 generateSphere() 而不是 gen()。使用命名函数而不是匿名函数也可以产生更好的提示。
• 始终包括编写良好的 注释，描述您正在实现的任务以及输入/输出应该是什么。

  • 考虑在注释中包含一些带有预期结果的示例调用。
  • 建议如何解决问题，例如 -- 使用射线投射。
  • 使用您定义的确切函数或变量名称，例如 -- 创建 10 个 greenSphere 对象 而不是 -- 创建 10 个球体。
• 如果您是初学者脚本编写者，可以从基本项目开始，例如“当玩家触碰部件时让他们跳跃”或使用工具生成小代码片段，随着知识的增长进行扩展。

限制

该工具帮助自动化基本编码任务，但并不总是建议完美的代码。已知的限制包括：

• 手动触发并不 总是 强制生成建议。
• 建议是从代码语料库中机器学习得来的，因此可能反映出它们所训练代码的一些限制。例如，建议可能不会使用较新的 API，而是使用较旧的 API，或者它们可能使用 Lua 而不是 Luau。
• 该工具可能生成不正确或误导的信息，这对您的目的没有用处。
• 内部过滤器试图阻止冒犯性语言，但并不是全面的，工具可能会生成冒犯性或偏见的信息。
• 建议可能在用户之间相同、相似或不同，即使使用相同的提示。然而，您的代码将永远不会与他人共享。
• 由于学习模型的输出长度有限，建议可能不完整。
• 每天的建议数量有限制，一旦达到限制，您将在第二天之前不会收到任何建议。

代码隐私

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

此外，所有建议都是由 AI 模型生成的，并不会从一个用户转移到另一个用户。由于您的代码未用于模型训练，因此不会建议给 代码助手 的其他用户，唯一的例外是代码被发布到免费市场项目中。

多光标

脚本编辑器支持使用多个光标同时进行编辑。您可以根据需要通过鼠标点击或键盘快捷键添加光标。初始光标称为 主光标，额外的光标称为 次光标。

• 您在主光标处所做的编辑会复制到次光标。每次编辑计为一个操作，因此撤销/重做编辑适用于所有光标。
• 小部件，例如 自动完成，出现在主光标上，但不在次光标上。
• 所有标准的 键盘快捷键 用于脚本编辑都适用于多光标编辑，包括代码缩进、切换注释和删除行。

以下表格总结了多光标工作流程及其快捷键。

添加光标

您可以通过组合键盘快捷键和鼠标操作来添加光标。如果光标占据相同的空间，则光标会合并，例如，如果您使用箭头键添加光标或删除光标之间的所有字符。

在鼠标位置

要在鼠标指针位置添加光标：

1. 在 Windows 上按住 Alt，或在 Mac 上按住 ⌥。

2. 点击您想要添加光标的位置。

使用鼠标拖动

您可以拖动鼠标以将光标添加到选择中，将多行选择拆分为行，或选择代码/空白的列和块。

要通过拖动将光标添加到代码选择中：

1. 在 Windows 上按住 Alt，或在 Mac 上按住 ⌥。

2. 点击并拖动鼠标覆盖代码选择。

在主光标上方和下方

要在主光标的正上方或正下方添加光标：

1. 在 Windows 上按住 CtrlAlt，或在 Mac 上按住 ⌘⌥。

2. 按 ↑ 或 ↓ 箭头。

对匹配选择

您可以将光标添加到所有匹配的选择或下一个/上一个匹配，并可选择切换匹配是否区分大小写和/或匹配整个单词。

要将光标添加到所选部分的所有匹配项：

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

2. 在 Windows 上按 ShiftAltL，或在 Mac 上按 Shift⌥L。

移除光标

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

在鼠标位置

要移除光标：

1. 在 Windows 上按住 Alt，或在 Mac 上按住 ⌥。

2. 点击您想要移除的光标。

最近添加的光标

要移除最近添加的光标，请在 Windows 上按 CtrlU，或在 Mac 上按 ⌘U。

复制和粘贴光标

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

• 如果光标数量相同，则每个复制的光标粘贴到每个对应的目标光标。
• 如果光标数量不同，则目标处的每个光标接收整个粘贴，每个复制的光标作为新行。

输入时格式化

按下回车/返回将自动缩进每个光标到新行，相对于前一行。如果前一行以不完整的块开头，格式化程序将尝试完成它。

编辑器设置

许多自定义选项可以通过 Studio 设置 的 脚本编辑器 选项卡访问。常见的修改选项包括：

键盘快捷键

脚本编辑器具有以下键盘快捷键。