腳本編輯器

*此內容是使用 AI(Beta 測試版)翻譯,可能含有錯誤。若要以英文檢視此頁面,請按一下這裡

Studio 中的 指令編輯器 是 Roblox 上的主要程式碼編寫工具。這是一個自行改進的環境,可以幫助您撰寫高影響程式碼、縮短您的開發時間和重複您的體驗。它可以改善您的程式碼體驗:

  • 在您的代碼中格式和強調語法。
  • 提供您輸入時自動完成語言的方法。
  • 幫助您 瀏覽程式碼 跳轉至變數和函數宣言。
  • 幫助您查找並替換開啟指令碼或所有指令碼的代碼。
  • 提供 實時意見反應 關於您的代碼品質和履約。

腳本編輯器支持所有類型的腳本,並在您創建新腳本或在 Explorer 窗口中雙擊已存在的腳本時自動開啟。

自動完成功效

腳本編輯器的自動完成功效會生成與程式設計有關的資訊,例如:

  • 在資料模型上完成文字的建議 關於如何完成文字,當您輸入它們時,它們與體驗的 資料模型 有上下文。例如,如果您有 Class.Model

    Autocomplete showing suggestions based on the experience's data model
  • 自動填寫名稱 對您宣告的變數和函數,幫助您避免討厭的代碼。

    Autocomplete showing suggestions based on a previously declared variable.
  • 文件資料檢索樣本頁面,與 Engine API 參考 頁面相似,提供 API 使用上的上下文。

    Autocomplete showing suggestions based on a Roblox engine API.
  • 在擁有自己的定義文件的情況下自訂的 工具提示。

    Autocomplete showing custom documentation.
  • 在擺動時分析指令碼分析結果 ,並提供可以用於排查錯誤的資訊。

    Autocomplete showing diagnostic information.
  • 功能簽名 當您輸入參數和返回值時,提供參數和返回值的引用。

    Autocomplete showing function signature

代碼導航

前往宣言

您可以跳到功能或變量的宣言,持有 Ctrl 在 Windows 上或 在 Mac 上,當單擊撥動時,或右擊撥動撥動它並單擊 前往說明

Go to Declaration workflow on a declared function

腳本功能過濾器

腳本功能過濾器 顯示一個列表所有在腳指令碼中宣告的功能。要打開它,請按 AltF 在 Windows 上或 0>⌥0> 2>F2> 在 Mac 上按一下。當列表打開時,您可以瀏覽每個功能的標籤,

Script Function Filter showing all functions inside a script

尋找並替換

查找/替換 按鈕可以在開放式腳指令碼中找到並替換代碼。按鈕支援正確的案件,並且搜尋以正確的文字搜尋。要開啟它,請按 CtrlF 在 Windows 上或 1>⌘1> 在 Mac 上按。

Find/Replace widget labeled

即時反饋

腳本分析

指令分析視窗,可從 視圖 標籤存取,執行靜態分析您的指令並顯示錯誤和警告。有關錯誤和警告的更多資訊,請參閱 Luau linting 文件。

Script with various marked errors
在指令編輯器中所標示的錯誤指令
Script Analysis window with details on marked errors from script
錯誤說明在指令分析窗口中

輸出窗口

輸出窗口,可從檢視標籤存取,顯示由執行指令、來自 Roblox 引擎、來自呼叫print()、來自呼叫1> warn()1>和來自呼叫4> print4>的錯誤。有關設定它為您的工作流程的詳細信息,請參閱7>輸出窗口</

代碼助手

代碼助手 是一項建議您輸入時輸入代碼的線或函數的功能,幫助您更有效率地輸入代碼並保持專注。基於您的評論和代碼的上下文,建議會在兩個方式中觸發:

  • 自動 當您在幾秒鐘內暫停時,AI 模型有足夠的上下文可以提出建議。
  • 手動 使用快捷方式 Alt 在 Windows 上或 1>∖1> 在 Mac (您可以 4>自訂 4> 此快捷方式)。

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

改進建議

為了獲得更準確和相關的建議,建議您遵循清潔的編程習慣,無論是否提供協助,並且:

  • 將您的代碼分解為更小的功能。
  • 使用說明性的腳本名稱來捕捉每個腳本的總意。例如,名稱一個腳本 SyncCustomSounds 而不是只有 Sounds
  • 為參數、函數和指令命名說明性名稱。例如,命名零件 綠色球體 而不是只是 grs ,或命名函數 generateSphere() 而不是 1> gen1>。使用命名函數與匿名函數來產生更好的提示。
  • 包含一致的 評論 描述您正在實現的任務和輸入/輸出的應該是什麼。
    • 請考慮包含一些預期結果的範例調用。
    • 建議如何解決問題,例如 -- Use raycast
    • 使用您定義的正確功能或變量名稱,例如 -- Create 10 greenSphere objects 而不是 -- Create 10 spheres
  • 如果您是新手程式員,請從「製作玩家跳躍時碰觸零件」或「使用工具產生小範圍程式碼,以便您可以隨著知識的增長而擴展」開始。

限制

工具幫助自動化基本程式碼任務,但它並不總是建議完美碼。已知的限制包括:

  • 手動触發不會強制生成建議。
  • 建議是從代碼中獲得機器學習的,因此可以反映一些代碼在它們訓練在的代碼上的限制。例如,建議可能不會使用最新的 API 而是使用較舊的 API,或使用 Lua 而不是 Luau
  • 工具可能會生成不妥或引人誤解的資訊,這不是您的目的。
  • 內部過濾器嘗試阻止攻擊語言,但它們不是全面的,並且有可能工具會生成攻擊或歪曲的信息。
  • 建議可能會是相同的、相似的或不同的,即使是相同的提示。您的代碼, however,永遠不會與其他人分享。
  • 建議可能因為學習模型的輸出有限的長度而不完整。
  • 每日上限有 2 個建議,達到上限後,就會在第二天再獲得一個建議。

代碼隱私

目前,Roblox 不使用任何非公開資料來訓練學習模型。 工具只使用小範圍的免費市場資產來調整大型語言模型,並且對於大語言模型進行了各種檢查。

此外,所有建議都是由 AI 模型生成 ,因此不會從一個用戶轉移到另一個用戶。因為您的代碼不是用於模型訓練,因此 代碼助手 不會建議其他用戶的 免費市場項目,只有發布到免費市場項目的代碼。

多重指针

腳本編輯器支援多個貫線以同時編輯。你可以基於需求添加貫線,例如滑鼠點擊或鍵盤快捷方式。初始曲線為 主曲線 ,並且為 秒鐘曲線

  • 你在主要曲標複製到秒級曲標。每次編輯都會計為一個行動作,所以編輯的還原/重做適用於所有曲標。
  • 自動完成 這樣的 widget 會在主要指针上出現,但不會在次要指针上出現。
  • 所有標準 鍵盤快捷方式 對於編輯程式碼工作,包括程式碼折舊、切換標籤和刪除行。

下表總結了多重程序員工作流程和其簡潔。

指揮部WindowsMac
在滑鼠位置添加/移除鼠標按鈕 Alt 按一下 +按一下
移除最近新增的指针 CtrlUU
添加/修改滑鼠拖動時的指針 Alt +拖曳 +拖曳
添加指针上方/下方 Ctrl AltCtrl 0>Alt0> 2>向下2> 0>⌥0> 2>↓2>
添加指针到下一個匹配選擇 CtrlDD
在每個相符選擇添加指针 Shift Alt LShift L
柱/積木選擇 Shift Alt 拖曳Shift 拖曳
將選擇分為幾條線 Shift Alt IShift I

新增控制器

您可以使用鍵盤快捷鍵和滑鼠操作結合來添加指標。指標會合併,如果它們位於相同的位空間,例如添加指標與箭頭鍵或刪除所有角色之間的所有角色。

在滑鼠位置

要在您的鼠標指针位置添加指针:

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

  2. 點擊您想要添加鼠標的位置。

使用滑鼠拖動

您可以拖曳鼠標添加選擇中的鼠標指針,將多條選擇分成一行,或選擇滾動條碼/白色空格。

要在拖曳代碼選擇中添加指针:

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

  2. 按一下並拖曳您的鼠標選擇代碼。

上方和下方主要鼠標指針

要在主要曲柄上或下方增加一個指針:

  1. 按住 CtrlAlt 在 Windows 上或 在 Mac 上。

  2. 按下 箭頭。

匹配選擇

您可以在選擇的所有比賽中添加指標,或者在下一個/上一個相符賽中切換是否要求對應字串。

要在選擇的區域的所有匹配中添加指针:

  1. 選擇您想要搜尋的比賽。

  2. 在 Windows 上按下 ShiftAltL 或在 Mac 上按下 1> Shift1> 4>⌥4> 7>L7>。

移除螢幕

您可以使用以下鍵盤快捷鍵和滑鼠操作移除游標。或者,您可以按下 Esc 來退出多重編輯。

在滑鼠位置

要移除游標:

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

  2. 按一下你想要移除的指针。

最近新增

要移除最近新增的指针,請按 CtrlU 在 Windows 上或 0>U0> 在 Mac 上。

複製並貼入指針

複製代碼的一個選擇包括在它內的曲柄。 貼膏的行為取決於來源上的曲柄數和目的地上的曲柄數:

  • 如果曲柄數是相同的,則每個複製的曲柄都會粘貼到每個相應的目標曲柄。
  • 如果曲柄數量不同,則在目的地的每個曲柄都會收到所有複製的曲柄作為新行。

隨時形式

按下Enter/Return會自動擷取每個鼠標位置,相對於上一條線。 如果上一條線是由不完整的方磚塊開始的,則表格器會嘗試完成它。

編輯器設定

許多自訂選項可以通過 檔案 頁面來存取; Studio 設定 ( Alt 0> S0> 在 Windows 上; 3> ⌥3> 5> S5> 在 Mac)。

A close up view of the Studio Settings window with the Script Editor tab selected.

常見修改選項包括:

選項說明
字體 編輯器中的代碼字體面和大小。
標籤寬度 代表 Tab 重新擺動的位置。
使用空格來增加內容 啟用時,空格與 Tab 按下度相等。
文字包裝 啟用時,長度超出指定的程式碼會包裝在下一行。
指令編輯器顏色預設 為代碼元素、選擇顏色和更多設定顏色。選擇一個預設後,您可以為選項設定特定顏色,例如 選擇顏色評論顏色

鍵盤快捷方式

腳本編輯器具有以下鍵盤快捷鍵。您也可以從 Studio 工具欄中的 腳本 標籤查看或編輯腳指令碼。

指揮部WindowsMac
關閉指令碼 CtrlWW
重新開啟最近關閉的脚本 CtrlShiftTShiftT
快速開啟 CtrlPP
在 Explorer 中顯示程式碼 CtrlAltKK
放大 Ctrl ="=
向外捲動 Ctrl--
重設腳本放大倍率 Ctrl00