工具用的順手嗎?
你的回饋能幫助我們做得更好
在瀏覽器中使用官方 Luau Playground 分析 Roblox Luau 程式碼,查看型別診斷與提示。
分析器由 play.luau.org 託管,程式碼在該頁面的瀏覽器執行環境中處理。本頁不會將程式碼放入網址;請勿在第三方頁面貼上機密原始碼。Roblox Studio 專案仍應使用專案實際的型別定義與設定複核診斷。
概覽
了解工具能解決的問題、計算或處理邏輯,以及資料邊界。
Luau 靜態分析會在不執行遊戲的情況下檢查原始碼,協助發現型別不符、可能的 nil 值問題,以及分析器能辨識的程式診斷。頁面嵌入 Luau 官方 Playground,分析能力來自該線上環境。它是為 Luau 語言及其工具鏈設計,不應當成標準 Lua、LuaJIT 或其他宿主腳本的通用檢查器。
Roblox 專案通常使用 Luau 型別語法、內建型別和平台 API。線上分析可快速檢查獨立片段、教學範例或問題重現;但工程中的完整結果仍取決於專案模組、型別宣告、嚴格模式設定和 Roblox API 環境。型別檢查通過,只表示分析器在目前上下文沒有回報對應問題,不能證明遊戲行為正確。
指南
依步驟完成操作,並透過範例核對輸入與結果。
在嵌入的編輯器輸入或貼上 Luau 程式碼。先使用短小且可獨立閱讀的片段,讓診斷容易對應到宣告與運算式。
查看編輯器顯示的語法、型別和 lint 提示。將游標移到提示位置,並檢查相關變數的宣告、指定與回傳型別,判斷問題來源。
若要確認型別行為,請補上明確型別標註,並確認程式使用 Luau 支援的寫法。若要比較嚴格模式差異,應在目標腳本設定相同模式後重新檢查。
修正診斷後回到 Roblox Studio,在實際專案再次分析並執行。模組匯入、物件階層、服務物件和自訂型別不一定存在於獨立 Playground 的上下文。
情境
查看這項工具在不同工作與生活流程中的用法。
學習 Luau 型別系統時,可以在 Playground 試驗可選型別、聯集型別、表格結構和函式簽章,再觀察分析器如何推導指定與呼叫。這比為了單一語法問題建立完整專案更快速,也方便分享可重現的短範例。
維護 Roblox 腳本時,可將不依賴專案模組的邏輯片段貼入,初步定位型別警告或語法錯誤。這適合快速排查和教學示範;若程式依賴專案模組、外掛 API 或自訂宣告,最終診斷仍應以 Roblox Studio 和專案設定為準。
問答
集中解答常見疑問與容易混淆的問題。
不適合作為通用檢查器。嵌入的官方 Playground 以 Luau 為目標,其型別分析和語言擴充與標準 Lua、LuaJIT 不同。一般 Lua 專案應選擇符合執行環境的剖析器或靜態檢查工具。
不代表。靜態分析不會完整模擬遊戲執行、網路狀態、物件生命週期或所有 API 行為。請將程式放回實際專案,在 Studio 核對診斷並執行相關情境。
獨立 Playground 不會自動載入本機模組、專案型別定義和腳本設定。缺少宣告或嚴格模式不同,都可能造成結果不一致;請提供自包含範例,並以工程分析為準。
須知
使用前了解適用範圍、結果限制與必要提醒。
本頁嵌入 Luau 官方 Playground,編輯器由 play.luau.org 提供,分析器在該頁面的瀏覽器上下文中執行。本服務不會將原始碼寫入嵌入頁面的網址;第三方頁面仍有自己的資料處理方式與網路請求。提交前請遵循組織的程式碼管理規範,勿輸入金鑰、憑證、未公開商業程式碼或個人資料。
Luau 型別檢查是 IDE 工作流程的補充,方便分享和試驗獨立片段,不能取代 Roblox Studio、專案宣告檔或團隊持續整合檢查。官方環境更新後,提示和介面也可能改變;若結果與專案不同,請記錄最小重現,並在相符的 Studio 版本中複查。
推薦
查找相關工具、專題與可用的 API 能力。