脚本编辑器

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

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

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

自动完成特点

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

• 根据经验的 数据模型 提供的上下文相关建议。例如，如果你有一个在 Workspace 中的 Model 叫做 RocketShip，当你输入 workspace.roc 时，自动完成会建议 RocketShip，并指明它是一个 Model。

  

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

• 自动填充 你声明的变量和函数的名称，帮助你避免恼人的输入错误。

  

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

  

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

  

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

  

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

  

代码导航

跳转到声明

按住 Ctrl（Windows）或 ⌘（Mac）并点击调用，或右键点击其调用并选择 转到声明，可以跳转到函数或变量的声明。

脚本函数过滤器

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

查找和替换

查找/替换 小工具可以让你在打开的脚本中查找和替换代码。该小工具支持匹配大小写、匹配整个单词和按正则表达式搜索。要打开它，请按 CtrlF（Windows）或 ⌘F（Mac）。

实时反馈

脚本分析

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

输出

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

代码助手

代码助手 是一项功能，在你输入时建议代码行或函数，帮助你更有效地编码并保持专注。基于你注释和代码的上下文，建议会以两种方式触发：

• 自动，当你在一行上停顿几秒钟时，且 AI 模型具有足够的上下文来提供建议。
• 手动，通过快捷键 Alt∖（Windows）或 ⌥∖（Mac）。

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

改善建议

为了获得更准确和相关的建议，建议你遵循干净的编码实践，不管是否有助手帮助，并：

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

  • 考虑在注释中包含一些示例调用及其预期结果。
  • 提出解决问题的建议，例如 -- 使用射线检测。
  • 使用你定义的确切函数或变量名称，例如 -- 创建 10 个 greenSphere 对象 而不是 -- 创建 10 个球体。
• 如果你是初学者，可以从简单的项目入手，例如 “让玩家在接触该部件时跳跃” 或使用该工具生成小代码片段，然后随着知识的增长逐步扩展。

限制

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

• 手动触发并不 总是 强制生成建议。
• 建议是从一组代码机器学习而来，因此可能反映所训练代码的一些限制。例如，建议可能不会使用较新的 API，而倾向于采用较旧的 API，或可能使用 Lua 而不是 Luau。
• 工具可能生成不正确或误导性的信息，对你的目的没有帮助。
• 内部过滤器尝试阻止攻击性语言，但并不是全能的，工具可能仍会产生攻击性或有偏见的信息。
• 不同用户之间的建议可能是相同、相似或不同，即使提示相同。你的代码不会与其他人共享。
• 由于学习模型输出长度的限制，建议可能不完整。
• 每日建议数量有限制，一旦达到限制，你将在第二天之前无法获得任何建议。

代码隐私

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

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

多光标

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

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

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

添加光标

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

在鼠标位置

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

1. 按住 Alt（Windows）或 ⌥（Mac）。

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

使用鼠标拖动

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

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

1. 按住 Alt（Windows）或 ⌥（Mac）。

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

在主光标上方和下方

要在主光标直接上方或下方添加光标：

1. 同时按住 CtrlAlt（Windows）或 ⌘⌥（Mac）。

2. 按 ↑ 或 ↓ 箭头。

对匹配选择添加光标

你可以对选择的所有匹配项添加光标或对下一个/上一个匹配项添加光标，选项地切换是否匹配大小写和/或匹配整个单词。

要对选定部分的所有匹配添加光标：

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

2. 按 ShiftAltL（Windows）或 Shift⌥L（Mac）。

移除光标

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

在鼠标位置

要移除光标：

1. 按住 Alt（Windows）或 ⌥（Mac）。

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

最近添加的光标

要移除最近添加的光标，按 CtrlU（Windows）或 ⌘U（Mac）。

复制和粘贴光标

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

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

输入时格式化

按 Enter/Return 将自动缩进每个光标到新行相对前一行。如果前一行以不完整的块开始，格式化工具将尝试完成它。

编辑器设置

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

键盘快捷键

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