腳本編輯器

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

• 格式化和高亮顯示代碼中的語法。
• 提供在您輸入時自動完成代碼短語的方式 autocomplete。
• 通過跳轉到變量和函數聲明來幫助您 navigate code。
• 幫助您在打開的腳本或所有腳本中 find and replace 代碼。
• 提供有關代碼質量和性能的 real-time feedback。

腳本編輯器支持所有類型的 scripts，並在您創建新腳本或雙擊現有腳本時自動打開 Explorer 窗口。

自動完成功能

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

• 知情建議，在您輸入短語時提供上下文相關的建議，這些建議與遊戲的 data model 相關。例如，如果您在 Workspace 中有一個名為 RocketShip 的 Model，當您輸入 workspace.roc 時，自動完成會建議 RocketShip，並指示它是一個 Model。

  

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

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

  

• 帶有代碼示例的文檔彈出窗口，類似於 Engine API Reference，為您提供 API 使用的上下文。

  

• 懸停工具提示，您可以使用自己定義的文檔進行自定義。在函數、變量或其他聲明之前放置 block comment，當您稍後懸停在名稱上時，腳本編輯器會顯示該註釋作為工具提示。這在聲明出現在類型表達式內時也有效，例如 typeof()：

  export type Icon = {
  	new: typeof(--[[構造一個空的圖標。]] function(): Icon
  		return (nil :: any) :: Icon
  	end),
  }

  

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

  

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

  

代碼導航

跳轉到聲明

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

腳本函數過濾器

腳本函數過濾器 顯示腳本中所有聲明的函數的列表。要打開它，請在 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()。使用命名函數而不是匿名函數也可以產生更好的提示。
• 一致地包含寫得好的 comments，描述您正在實現的任務以及輸入/輸出應該是什麼。

  • 考慮在註釋中包含一些示例調用及其預期結果。
  • 建議如何解決問題，例如 -- 使用射線投射。
  • 使用您定義的確切函數或變量名稱，例如 -- 創建 10 個 greenSphere 對象 而不是 -- 創建 10 個球體。
• 如果您是新手腳本編寫者，請從基本項目開始，例如“當玩家觸碰部件時使其跳躍”或使用該工具生成小代碼片段，隨著知識的增長進行擴展。

限制

該工具幫助自動化基本編碼任務，但並不總是建議完美的代碼。已知的限制包括：

• 手動觸發不 總是 強制生成建議。
• 建議是從代碼語料庫中機器學習的，因此可能反映出它們所訓練的代碼的一些限制。例如，建議可能不使用較新的 API，而偏向於較舊的 API，或者它們可能使用 Lua 而不是 Luau。
• 該工具可能生成不正確或誤導的信息，對您的目的沒有用處。
• 內部過濾器試圖阻止冒犯性語言，但它們並非全能，該工具可能生成冒犯性或有偏見的信息。
• 建議可能在用戶之間相同、相似或不同，即使使用相同的提示。不過，您的代碼將永遠不會與他人共享。
• 由於學習模型的輸出長度有限，建議可能不完整。
• 每天的建議數量有限制，一旦達到上限，您將在第二天之前不會收到任何建議。

代碼隱私

目前，Roblox 不使用任何非公開數據來訓練學習模型。該工具僅使用一小部分免費市場資產來調整大型語言模型，並且該子集已通過各種質量和安全過濾檢查。

此外，所有建議都是 由 AI 模型生成的，並不會從一個用戶轉移到另一個用戶。由於您的代碼不會用於模型訓練，因此不會建議給 代碼助手 的其他用戶，唯一的例外是代碼被發佈到免費市場項目中。

多光標

腳本編輯器支持使用多個光標同時進行編輯。您可以根據需要通過鼠標單擊或鍵盤快捷鍵添加光標。初始光標稱為 主光標，額外的光標稱為 次光標。

• 您在主光標處所做的編輯會複製到次光標。每次編輯計算為一個操作，因此編輯的撤消/重做適用於所有光標。
• 小部件，例如 autocomplete，出現在主光標上，但不會出現在次光標上。
• 所有標準 keyboard shortcuts 用於腳本編輯的功能都適用於多光標編輯，包括代碼縮進、切換註釋和刪除行。

以下表格總結了多光標工作流程及其快捷鍵。

添加光標

您可以通過鍵盤快捷鍵和鼠標操作的組合來添加光標。如果光標佔據相同的空間，則光標會合併，例如，如果您使用箭頭鍵添加光標或刪除光標之間的所有字符。

在鼠標位置

要在鼠標指針位置添加光標：

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 Settings 的 腳本編輯器 標籤訪問。常見的修改選項包括：

鍵盤快捷鍵

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