指令碼編輯器

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

• 在您的代碼中格式化和強調語法。
• 提供方法來 自動完成 代碼中的短語，當您輸入時。
• 幫助你導航代碼，跳到變量和函數宣言。
• 幫助您在開啟的腳本或所有腳本中找到並替換代碼。
• 為您的代碼質量和履約提供 實時反饋。

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

自動完成功能

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

• 通知建議 如何在你輸入句子時完成與經體驗 數據模型 相關的建議。例如，如果你有 Model 在 Workspace 稱為 火箭飛船 ，自動完成建議 RocketShip 當你輸入 workspace.roc 並指示它是 Model 。

  

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

• 自動填充名稱 對你宣告的變量和函數，幫助你避免煩人的拼字錯誤。

  

• 具有代碼樣本的文檔彈出窗口 與 引擎 API 參考 相似，為您提供 API 的使用上下文。

  

• 在懸停時的工具提示 您可以自定義自己定義的文檔。

  

• 在懸停時的腳本分析診斷 具有你可以使用來排除錯誤的資訊。

  

• 功能簽名 當您輸入一個引數數時，為您提供其參數和返回值的參考。

  

代碼導航

前往宣言

您可以在點擊呼叫時按住 在 Windows 上跳到函數或變量的宣言，或在 Mac 上按右鍵點擊其呼叫並點擊 前往宣言 。

腳本功能過濾篩選器

腳本功能過濾器 顯示一個列表，包含所有在腳指令碼中宣言的功能。要開啟它，請在 Windows 上按下 Alt F 或在 Mac 上按下 ⌥ F 。開啟清單後，您可以瀏覽每個函數的簽名，按名稱過濾它們，然後雙擊一個以跳到其宣言。

尋找並替換

尋找/替換 widget 讓你在開啟的腳指令碼中尋找和替換代碼。 widget 支持匹配案件、匹配整個字詞和搜索常規表達式。要開啟它，請在 Windows 上按下 Ctrl F 或在 Mac 上按下 ⌘ F 。

實時反回饋

腳本分析

從 檢視 標籤存取的 腳本分析窗口，對您的腳本進行靜態分析，並顯示已啟用的錯誤和警告。有關錯誤和警告的更多信息，請參閱 Luau 檢查 文件。

輸出

從 檢視 標籤存取的 輸出窗口，顯示從執行腳本中捕捉到的錯誤、來自 Roblox 引擎的訊息、來自呼叫 print() 的錯誤以及來自呼叫 warn()的錯誤。有關如何為您的工作流程配置它的詳情，請參閱輸出。

代碼助理

代碼助理 是一項功能，會在您輸入代碼時建議線或功能的代碼，幫助您更有效地編寫代碼並保持專注。根據你的評論和代碼的上下文，建議會以兩種方式被觸發：

• 自動 當你暫停幾秒鐘在一行上，AI模型有足夠的上下文以進行建議時
• 手動 使用快捷方式 在 Windows 上或 在 Mac 上 (您可以 自定义 此快捷方式).

按下 Tab 接受建議，或繼續輸入以忽略它。目前，您的腳本需要包含至少幾行代碼才能觸發建議。

改進建議

若要獲得更準確和相關的建議，建議您遵循清潔編寫習慣，無論是協助或不協助：

• 將您的代碼拆解為更小的功能。
• 使用描述性的腳本名稱，捕捉每個腳本的整體意圖。例如，命名一個腳本 SyncCustomSounds 而不是只有 聲音 。
• 為參數、函數和腳本指定描述性名稱。例如，命名零件 綠色球體 而不是只有 grs , 或命名函數 generateSphere() 而不是 gen() 。使用命名的函數與匿名函數也可以產生更好的提示。
• 一致包含良好的 評論 ，描述你正在實現的任務和輸入/輸出應該是什麼。

  • 考慮在評論中包含一些樣本呼叫並附上預期的結果。
  • 建議如何解決問題，例如 -- Use raycast 。
  • 使用您定義的準確功能或變量名稱，例如 -- Create 10 greenSphere objects 而不是 -- Create 10 spheres 。
• 如果你是新手程式員，請開始使用基本項目，例如「當使用者觸碰零件時讓玩家跳躍」或使用工具產生小型程式碼片段，以便隨著你的知識增長而擴展。

限制

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

• 手動觸發不會 總是 強制生成建議。
• 建議是從一個代碼庫中機器學習的，因此可以反映它們訓練的代碼的一些限制。例如，建議可能不會使用較新的 API 來取代較舊的 API，或者可能會使用 Lua 而不是 Luau。
• 工具可能會生成不適合您用途的錯誤或誤導性資訊。
• 內部過濾器嘗試阻止攻擊性語言，但它們並不包容所有，也許工具會生成攻擊性或偏見的信息。
• 建議可能會在使用者之間相同、相似或不同，即使使用相同的提示。但是，您的代碼永遠不會與其他人共享。
• 建議可能因學習模型的輸出長度有限而不完整。
• 每天對建議數量有限制，一旦達到限制，你將無法在下一天獲得建議。

代碼隱私權、隱私

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

此外，所有建議都由AI模型生成 並 不會從一個用戶傳送到另一個用戶。由於您的代碼未用於模型訓練，因此不會建議其他使用 代碼助理 的用戶將代碼發布到免費市場項目。

多重指標

腳本編輯器支持使用多個鼠標同時進行編輯。您可以通過滑鼠點擊或鍵盤捷徑來添加基於需求的鼠標指針。初始曲標稱為 主要曲標 ，額外的曲標稱為 次要曲標 。

• 您在主要光標複製到次要光標時所做的編輯。每次編輯都算作一個動作，因此編輯的撤消/重做適用於所有的鼠標。
• Widgets，例如 自動完成 出現在主要鼠標上，但不是在次要鼠標上。
• 所有標準 腳本編輯快捷鍵 用於編輯腳本的工作都使用多重指標編輯，包括代碼括號、切換評論和刪除行。

下表總結了多個指標工作流程和其快捷方式。

新增指標

您可以使用鍵盤熱鍵和滑鼠操作的組合來添加鼠標。如果指針佔用相同的空間，例如你添加指針使用箭頭鍵或刪除指針之間的所有字符，它們將合併。

在滑鼠位置

要在滑鼠指針位置添加鼠標指示器：

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

2. 單擊您想添加鼠標的地方。

使用滑鼠拖動

您可以拖動鼠標以添加指標到選擇、將多行選擇分割為線條或選擇代碼欄和空白區塊。

要透過拖曳將鼠標添加到選擇的代碼：

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

2. 單擊並拖動鼠標到代碼選擇上。

超過和低於主要鼠標

要直接在主要鼠標上方或下方添加鼠標：

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

2. 按下 ↑ 或 ↓ 箭頭。

匹配選擇

您可以將鼠標添加到選擇的所有匹配項或下一個/以前的匹配相符，並可選擇是否匹配整個字詞或是否匹配大/小寫。

要將鼠標添加到選擇的部分所有匹配項目：

1. 選擇您想搜尋匹配的代碼。

2. 在 Windows 上按下 Shift Alt L 或在 Mac 上按下 Shift ⌥ L 。

移除指標

您可以使用以下快捷鍵和滑鼠操作來移除指標。或者，您可以點擊 Esc 退出多個指標編輯。

在滑鼠位置

要移除鼠標：

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

2. 點擊你想要移除的鼠標。

最近新增的最多

要移除最新添加的鼠標，請在 Windows 上按下 Ctrl U 或在 Mac 上按下 ⌘ U 。

複製並貼上指標

複製一個選擇的代碼包括其內的指標。粘貼的行為取決於來源中的鼠標數量和目的地的鼠標數量：

• 如果彎弧數量相同，則每個複製的彎弧粘貼到對應的目的地彎弧。
• 如果勾選器數量不同，則目的地的每個勾選器會收到每個複製的勾選器作為新行的整個粘貼。

在型態上的格式化

按下 Enter/Return 將自動在新行與前一行相對的位置標示每個指標器。如果前一行以不完整的方磚塊開始，格式器將嘗試完成它。

編輯器設定

許多自訂選項可以通過 檔案 > Studio設定 (AltS 在Windows上; ⌥S 在Mac上) 訪問。

常見修改的選項包括：

快捷鍵

腳本編輯器具有以下鍵盤熱鍵。您也可以從 腳本 標籤中存取許多指令，每當您查看或編輯腳指令碼時，腳本工具欄都會出現。