腳本編輯器

Studio 中的腳本編輯器 是 Roblox 上的主要腳本工具。它是一個自我改善的環境，可以幫助您編寫高影響力的程式碼，縮短開發時間，並反覆修改您的體驗。它可以通過以下方式改善您的腳本體驗：

• 格式化和高亮您的程式碼中的語法。
• 提供在您輸入時 自動完成 短語的方式。
• 幫助您 導航程式碼，通過跳轉到變數和函數聲明。
• 幫助您 查找和替換 打開腳本或所有腳本中的程式碼。
• 提供 實時反饋 以了解您的程式碼質量和性能。

腳本編輯器支援所有類型的 腳本，當您創建新腳本或雙擊現有腳本時，會自動打開它。

自動完成功能

腳本編輯器的自動完成功能會生成與程式碼相關的信息，能提高您的程式設計效率，例如：

• 知情建議 根據您輸入的上下文來完成短語，這些建議與體驗的 數據模型 相關。例如，如果您在 Workspace 中有一個名為 RocketShip 的 Model，當您輸入 workspace.roc 時，自動完成會建議 RocketShip 並表明它是一個 Model。

  

  使用 ↑ 和 ↓ 鍵來瀏覽建議，然後按 Tab 或 Enter 接受建議並插入完整的短語。

• 自動填充變數和函數名稱，幫助您避免討厭的錯字。

  

• 帶有程式碼範例的文檔彈出視窗，這些範例類似於 引擎 API 參考，為您提供有關 API 使用的上下文。

  

• 懸停提示，您可以使用自己定義的文檔進行自定義。

  

• 懸停腳本分析診斷，提供可以用來排除錯誤的信息。

  

• 函數簽名 當您輸入參數時，為您提供對其參數和返回值的引用。

  

程式碼導航

前往聲明

您可以通過在 Windows 上按住 Ctrl 或在 Mac 上按住 ⌘ 來點擊調用，或者通過右鍵單擊其調用並點擊 前往聲明 來跳轉到函數或變數的聲明。

腳本函數過濾器

腳本函數過濾器 顯示腳本中所有聲明的函數列表。要打開它，請在 Windows 上按 AltF，或在 Mac 上按 ⌥F。打開列表後，您可以瀏覽每個函數的簽名，按名稱進行過濾，並雙擊一個函數以跳轉到其聲明。

查找和替換

查找/替換 小工具讓您在打開的腳本中查找和替換程式碼。該小工具支持區分大小寫、匹配整詞和按正則表達式搜索。要打開它，請在 Windows 上按 CtrlF，或在 Mac 上按 ⌘F。

實時反饋

腳本分析

腳本分析 窗口可通過 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. 在 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。

複製和粘貼游標

複製程式碼的選擇包含其中的游標。粘貼的行為取決於來源中的游標數量和目標中的游標數量：

• 如果游標數量相同，則每個複製的游標將粘貼到每個對應的目標游標。
• 如果游標數量不同，則目標中的每個游標都會接收到整個粘貼，並將每個複製的游標作為新行。

輸入時格式化

按下 Enter/Return 將自動縮進每個游標到新行，與前一行相對。如果前一行以不完整的塊開始，格式化工具將嘗試完成它。

編輯器設置

許多自定義選項可以通過 Studio 設置 中的 腳本編輯器 標籤訪問。常見的修改選項包括：

鍵盤快捷鍵

腳本編輯器具有以下鍵盤快捷鍵。