重點摘要
從 Window 選單或 Script 分頁開啟 Output 視窗,按下 Play,再點擊第一個紅色錯誤。Studio 會在出錯的那一行開啟 Script。訊息會說明哪裡出了問題:attempt to index nil with 'Humanoid' 代表 .Humanoid 前面的值是 nil。修正這個值不存在的原因,再執行一次遊戲。
- 從清單中的第一個錯誤開始。下面的錯誤往往只是它造成的結果。
- 遊戲執行中的常見錯誤可以歸納成三種原因:值是
nil、名稱拼錯或還沒載入,或是程式碼在錯誤的一邊執行(伺服器或用戶端)。 - 如果完全沒有錯誤,通常是程式碼根本沒有執行。請檢查 Script 的類型、它在 Explorer 中的位置、它的
Enabled屬性,以及它等待的事件到底有沒有觸發。 - 要知道某一行的值實際上是什麼,可以用 print 加上標籤把它印出來,或是在那一行設定中斷點。
如何開啟 Output 並閱讀錯誤
Output 視窗是 Roblox 回報 Script 錯誤、引擎警告以及你的程式碼印出的所有內容的地方。它不一定是開著的,所以請在測試前打開它。如果你從來沒有執行過 Script,Script 新手教學一開始就會打開 Output,並從 Script 印出第一行文字。
- 從 Studio 的 Window 選單或 Script 分頁上的按鈕開啟 Output。
- 用 Ctrl+K(Mac 上是 ⌘K)清除舊訊息,只看這次測試的內容。
- 按下 Play(F5),做出讓遊戲壞掉的動作。
- 找到第一行紅字。錯誤是紅色的。警告,例如
Infinite yield possible,會以橘色顯示。
遊戲執行中的錯誤在 Output 中長這樣。依照 Output 的顯示設定,每一行可能還會有時間、Client 或 Server 標籤,以及 Script 名稱。
ServerScriptService.CoinPad:14: attempt to index nil with 'Coins'
Stack Begin
Script 'ServerScriptService.CoinPad', Line 14 - function award
Script 'ServerScriptService.CoinPad', Line 27
Stack End
ServerScriptService.CoinPad是 Script 在 Explorer 中的位置:ServerScriptService 裡名為 CoinPad 的 Script。:14是發生錯誤的行號。- 行號後面的訊息說明哪裡出了問題。每一則都會在下方的常見錯誤清單中說明。
- Stack Begin 和 Stack End 之間的呼叫堆疊,從最近的一個開始,列出走到這裡的呼叫:
award函式中的第 14 行,而它是從第 27 行被呼叫的。
點擊紅色錯誤,Studio 就會開啟那個 Script,游標停在對應的那一行。在單人測試中,伺服器和你的用戶端的訊息會進到同一個 Output:伺服器的以綠色標示,用戶端的以藍色標示。上方的篩選器可以依訊息類型(Error、Warning)、執行環境(Client、Server)或文字縮小清單範圍。
適用於任何 Script 的除錯步驟
靠猜測並一次改好幾個地方,是修 Script 最慢的方法。不論有沒有錯誤訊息,這套步驟都會一步一步縮小問題範圍。
- 重現問題。清除 Output,按下 Play,準確地做出讓遊戲壞掉的動作。寫下你預期會發生什麼,以及實際發生了什麼。
- 抓住第一個錯誤。閱讀第一行新的紅字:Script 路徑、行號和訊息。如果沒有錯誤,請跳到沒有錯誤卻不運作的 Script 一節。
- 前往那一行。點擊錯誤。讀完整行,問問自己裡面哪個值可能是
nil、拼錯了,或是型別不對。 - 檢查值,不要用猜的。在那一行正上方加一個
print,或在那一行設定中斷點,並在 Watch 視窗查看各個值。typeof(x)會告訴你手上的是數字、字串、Instance 還是 nil。 - 沿著線索往回找。如果值不對,找出它是在哪裡設定的:什麼都沒找到的
FindFirstChild、什麼都沒回傳的函式,或是呼叫端始終沒有傳進來的參數。 - 修正原因,一次只改一處。修正名稱、等待物件,或把程式碼移到正確的一邊,然後再執行一次遊戲。不要用
pcall把那一行包起來讓它安靜:這樣只是把 bug 藏起來,而不是修好它。 - 確認結果。重複第 1 步。錯誤應該消失,而功能應該做到你預期的事。如果牽涉到其他玩家,還要用 Server & Clients 模式搭配兩個用戶端測試。
- 收拾乾淨。刪除或關閉除錯用的 print,讓下一個問題容易被發現。
Roblox 常見的 Script 錯誤與修正方法
每則訊息都依照同一個格式組成,再填入你的名稱,所以錯誤文字本身就是最好的提示。下面引號中的名稱,例如 'Health' 或 "Workspace",都只是範例。
| Output 顯示 | 意思 | 通常的修正方法 |
|---|---|---|
attempt to index nil with 'Health' | .Health 前面的值是 nil。 | 找出它為什麼是 nil,並在使用前用 if 檢查它。 |
Infinite yield possible on 'Players.YourName:WaitForChild("Character")' | WaitForChild 已經等了 5 秒,物件還是沒有出現。 | 修正名稱或路徑,確認有東西會建立這個物件,或加上逾時時間。 |
Bridge is not a valid member of Workspace "Workspace" | 那裡現在沒有名稱完全相符的子物件或屬性。 | 對照 Explorer 檢查拼字與大小寫。在用戶端請使用 WaitForChild。 |
attempt to call a nil value | 你呼叫了一個不是函式的東西。 | 檢查函式名稱,並確認它宣告在呼叫之前。 |
attempt to perform arithmetic (add) on Instance and number | 對不是數字的東西做數學運算。 | 對 value 物件使用 .Value,對文字使用 tonumber。 |
attempt to concatenate string with nil | .. 試圖把文字和 nil 或物件接在一起。 | 使用 tostring()、.Name 或字串插值。 |
Expected 'end' (to close 'function' at line 3), got <eof> | 語法錯誤。Script 完全不會執行。 | 修正 Script Editor 中用紅色底線標示的地方。 |
Requested module experienced an error while loading | ModuleScript 本身在執行時發生錯誤。 | 修正模組自己的錯誤,它就顯示在 Output 中稍微上面的地方。 |
Argument 1 missing or nil | Roblox 函式在需要值的地方收到了 nil。 | 追查這個參數原本應該從哪裡來。 |
FireServer can only be called from the client | RemoteEvent 從錯誤的一邊被呼叫。 | 伺服器使用 FireClient,LocalScript 使用 FireServer。 |
DataStore 錯誤 403,StudioAccessToApisNotAllowed | Studio 沒有被允許使用這個遊戲的 DataStore。 | 發布遊戲並開啟 Studio Access to API Services。 |
這裡列出的每一則訊息,以及更多其他訊息,都有自己的頁面,列出每一種原因、引發它的程式碼與修正方法:請參考 Roblox Studio 錯誤訊息,例如 attempt to index nil、Infinite yield possible 和 is not a valid member of。
attempt to index nil with 'X'
索引(index)就是用點或方括號讀取某個東西:part.Position、player.Character、list[1]。這個錯誤表示左邊的東西是 nil,而引號中的名稱是你想從它讀取的東西。所以在 player.Character.Humanoid 這一行,錯誤 attempt to index nil with 'Humanoid' 代表 player.Character 是 nil。如果鍵是數字,訊息會以 with number 結尾。
值會是 nil 的常見原因:
FindFirstChild、FindFirstChildOfClass或FindFirstAncestor什麼都沒找到,因為名稱不同,或是物件還不存在。- 在伺服器 Script 中使用了
Players.LocalPlayer。它只存在於 LocalScript,以及它們透過 require 載入的 ModuleScript 中;在伺服器上它永遠是 nil。請改用PlayerAdded或 RemoteEvent 處理函式提供的player。 - 在角色生成之前,或在它重生的過程中,讀取了
player.Character。 - 表格中的項目從來沒有被設定,例如在這位玩家的資料載入前就讀取
playerData[player],或是呼叫的函式什麼都沒有回傳。
典型的例子是致命方塊。壞掉的版本認為碰到零件的所有東西都屬於角色,但對被丟出的工具、沒有固定的零件和配件來說並不是這樣。
local part = script.Parent :: BasePart
part.Touched:Connect(function(hit: BasePart)
-- 壞掉的版本:
-- hit.Parent:FindFirstChild("Humanoid").Health = 0
-- 如果碰到的零件不是角色身體的一部分,FindFirstChild
-- 會回傳 nil,Output 就會顯示:
-- attempt to index nil with 'Health'
-- 修正版:每一步都先檢查再使用
local model = hit:FindFirstAncestorOfClass("Model")
local humanoid = model and model:FindFirstChildOfClass("Humanoid")
if humanoid then
humanoid.Health = 0
end
end)
如果寫成 hit.Parent.Humanoid,會出現另一則訊息 Humanoid is not a valid member of ...,下面會說明。即使碰到的零件位於角色身上的配件或手中工具裡,FindFirstAncestorOfClass("Model") 也能找到角色,所以手上的工具碰到方塊也算數。
修正這個錯誤的模式是:取得值、檢查它,然後才使用它。在伺服器上,對很可能不存在的東西,用 FindFirstChild 搭配 if 檢查就可以了。在 LocalScript 中,對伺服器建立的東西請使用 WaitForChild,因為它可能在 Script 開始執行之後才出現。
Infinite yield possible on ...
WaitForChild("Name") 會讓 Script 暫停,直到出現這個名稱的子物件。如果等了超過 5 秒,而你沒有設定逾時時間,Roblox 就會印出這個警告。這是警告而不是錯誤:Script 還在等待,在物件出現之前,這一行之後的程式都不會執行,而它可能永遠不會出現。常見原因:
- 名稱或父物件錯誤。
WaitForChild("leaderStats")永遠找不到leaderstats資料夾。 - 沒有東西建立這個物件:負責建立它的伺服器 Script 被關閉、放錯位置,或是更早之前就出錯了。請在 Output 中尋找更早的錯誤。
- LocalScript 在等待 ServerStorage 或 ServerScriptService 中的東西。它們的內容從來不會傳給玩家,所以這個等待永遠不會結束。
- 你在等待的是屬性,而不是子物件。常見的例子是
player:WaitForChild("Character"):Character是 Player 的屬性,不是它裡面的物件。 - 開啟了物件串流(
Workspace.StreamingEnabled),而零件離玩家太遠,所以還沒有傳送給這個用戶端。
local Players = game:GetService("Players")
local player = Players.LocalPlayer
-- 壞掉的版本:
-- local character = player:WaitForChild("Character")
-- Character 是 Player 的屬性,不是子物件,所以 Output 會警告:
-- Infinite yield possible on 'Players.YourName:WaitForChild("Character")'
local function onCharacterAdded(character: Model)
-- 設定逾時時間後,WaitForChild 會回傳 nil,而不是永遠等下去
local humanoid = character:WaitForChild("Humanoid", 10)
if not (humanoid and humanoid:IsA("Humanoid")) then
warn(`[DeathMessage] no Humanoid in {character:GetFullName()} after 10 seconds`)
return
end
humanoid.Died:Connect(function()
print(`[DeathMessage] {player.Name} died`)
end)
end
-- 處理可能已經存在的角色,之後再處理每一次重生
local current = player.Character
if current then
onCharacterAdded(current)
end
player.CharacterAdded:Connect(onCharacterAdded)
WaitForChild 的第二個參數是數字,代表以秒為單位的逾時時間。這樣 Script 就能用 warn 回報問題並乾淨地停下來,而不是默默卡住。
X is not a valid member of Y
你用點存取了當下不存在的子物件或屬性,例如 Workspace 中沒有名為 Bridge 的零件時寫了 workspace.Bridge。訊息中先是你要求的東西,接著是被搜尋物件的類別和完整路徑。請檢查三件事:
- 拼字和大小寫與 Explorer 完全一致。資料夾名稱是
leaderstats,全部小寫,而humanoid不是Humanoid。 - 屬性名稱用的是美式拼法。
part.Colour會出現Colour is not a valid member of Part "Workspace.Part"的錯誤;這個屬性叫做Color。 - 物件已經載入。在用戶端,伺服器建立的物件可能在 LocalScript 開始執行之後才送達,所以在那裡請使用
WaitForChild。
local Players = game:GetService("Players")
local player = Players.LocalPlayer
-- 壞掉的版本:
-- local coins = player.leaderstats.Coins
-- leaderstats 是伺服器建立的,可能在這個 Script 開始執行之後
-- 才送到這個用戶端。這時 Output 會顯示:
-- leaderstats is not a valid member of Player "Players.YourName"
local leaderstats = player:WaitForChild("leaderstats")
local coins = leaderstats:WaitForChild("Coins") :: IntValue -- 伺服器把 Coins 建成 IntValue
print(`[CoinsWatcher] starting coins: {coins.Value}`)
coins.Changed:Connect(function(newValue: number)
print(`[CoinsWatcher] coins changed to {newValue}`)
end)
這裡需要一個建立 leaderstats 並帶有名為 Coins 的 IntValue 的伺服器 Script,就像排行榜教學中的那樣。
attempt to call a nil value
程式碼在一個等於 nil 的東西後面加了括號,所以沒有東西可以執行。常見原因:
- 函式名稱拼錯或大小寫不同。模組宣告的是
Format.clock,呼叫端卻寫成Format.Clock(95)。 - 在
local function宣告之前的那一行就呼叫了它。那時這個名稱還不存在,所以請把宣告移到上面。 - ModuleScript 始終沒有把函式加進它回傳的表格中。
兩則類似的訊息指向同一種錯誤。用冒號呼叫表格中不存在的方法,會得到 attempt to call missing method 'Kill' of table。Roblox 物件方法的拼字錯誤,例如 part:Destory(),會得到 Destory is not a valid member of Part "Workspace.Part"。
attempt to perform arithmetic (add) on ...
Luau 嘗試做運算(add、sub、mul、div 等等),但其中一邊不是數字。訊息最後的型別名稱會提示你是哪一種情況:
on Instance and number:你拿 value 物件來運算,而不是它的數字。coins + 10應該寫成coins.Value + 10。on nil and number:變數或表格項目從來沒有被設定。給它一個初始值,或是在「沒有值」真的代表零的地方寫成(x or 0)。on string and number:不是數字的文字,常常來自 TextBox。用tonumber(text)轉換,並確認結果不是 nil。內容是數字的文字,例如"5",會自動轉換。
比較也會以同樣的方式出錯,出現 attempt to compare nil < number。Luau 會把 a > b 改寫成 b < a,所以訊息中的順序可能和你的程式碼相反。
local Players = game:GetService("Players")
local REWARD = 5
local INTERVAL_SECONDS = 60
local function addCoins(player: Player, amount: number)
local leaderstats = player:FindFirstChild("leaderstats")
local coins = leaderstats and leaderstats:FindFirstChild("Coins")
if not (coins and coins:IsA("IntValue")) then
-- 寫出為什麼什麼都沒發生,而不是保持沉默
warn(`[CoinDrip] {player.Name} has no leaderstats.Coins yet`)
return
end
-- 壞掉的版本:
-- coins = coins + amount
-- coins 是 IntValue 物件,不是它的數字,所以 Output 會顯示:
-- attempt to perform arithmetic (add) on Instance and number
coins.Value += amount
end
-- 每分鐘給伺服器上的每位玩家一些金幣
while true do
task.wait(INTERVAL_SECONDS)
for _, player in Players:GetPlayers() do
addCoins(player, REWARD)
end
end
attempt to concatenate string with nil
.. 運算子只能串接字串和數字。不能和 nil 串接,和物件也不行:"Hi " .. player 會得到 attempt to concatenate string with Instance。請使用 player.Name、用 tostring() 包住值,或是使用反引號的字串插值 print(`Coins: {coins}`),它會印出 nil,而不會讓 Script 停止。
Expected 'end' 及其他語法錯誤
以 Expected 開頭的訊息是語法錯誤:程式碼不是正確的 Luau,Roblox 無法編譯它,這個 Script 連一行都不會執行,包括錯誤上面的那些行。Script Editor 在你輸入時就會用紅色底線標出它們,所以可以在按下 Play 之前修正。
Expected 'end' (to close 'function' at line 3), got <eof>:從第 3 行開始的function、if、for或while缺少自己的end。訊息前面的行號常常指向檔案結尾,所以請看括號中指出的那一行。Expected 'then' when parsing if statement, got '=':條件中只有一個=。比較需要用==。Expected ')' (to close '(' at line 1), got 'local':括號始終沒有關上。Expected <eof>, got 'end':多了一個end。
縮排整齊的話,少掉或多出的 end 很容易看出來,因為每個區塊都和關閉它的 end 對齊在同一層。
Requested module experienced an error while loading
第一次對 ModuleScript 呼叫 require() 時會執行它的程式碼。如果模組在執行中出錯,載入它的 Script 就會收到這則訊息。真正的問題是 Output 中往上一兩行、模組自己的錯誤:請修正那個。兩則類似的訊息:
Module code did not return exactly one value:模組沒有以return結尾。ModuleScript 必須回傳一個不是 nil 的值,通常是它的表格。Requested module was required recursively:兩個模組互相載入對方。把共用的部分移到第三個模組,讓兩者都載入它。
local Format = {}
-- 把秒數轉換成分和秒:95 會變成 "1:35"
function Format.clock(seconds: number): string
local whole = math.max(0, math.floor(seconds))
return string.format("%d:%02d", whole // 60, whole % 60)
end
-- 模組最後必須回傳它的表格。少了這一行,每次
-- require 這個模組都會出錯:Module code did not return exactly one value
return Format
Script 透過 local Format = require(ReplicatedStorage:WaitForChild("Format")) 載入它,再呼叫 Format.clock(95)。如果寫成 Format.Clock(95),就會得到 attempt to call a nil value 錯誤。
Argument 1 missing or nil
Roblox 函式在需要的參數中收到了 nil,數字則告訴你是哪一個參數。當 itemName 是 nil 時,workspace:FindFirstChild(itemName) 就會這樣出錯。bug 很少就在這一行。它在值原本應該來的地方:拼錯的變數、從來沒有設定的屬性,或是用戶端沒有傳送的 RemoteEvent 參數。RemoteEvent 的參數來自玩家的裝置,所以伺服器必須在使用前檢查它們。具體做法請參考 RemoteEvent 教學。
FireServer can only be called from the client
RemoteEvent 是有方向的。LocalScript 呼叫 FireServer,伺服器 Script 用 OnServerEvent 接收。伺服器 Script 呼叫 FireClient 或 FireAllClients,LocalScript 用 OnClientEvent 接收。從錯誤的一邊呼叫方法,就會得到這個錯誤,或是反過來的 FireClient can only be called from the server。修正方法通常是把程式碼移到正確類型的 Script 中:請參考 Script、LocalScript 與 ModuleScript。
Studio 中的 DataStore 403 錯誤
在你允許之前,Studio 中的 DataStore 呼叫會以錯誤代碼 403(StudioAccessToApisNotAllowed)失敗。發布場景,打開 File、Experience Settings、Security,開啟 Enable Studio Access to API Services 並儲存。之後 Studio 會使用和正式遊戲相同的 DataStore,所以 Roblox 建議在另外的測試副本中這樣做,而不是在已經有人在玩的遊戲中。每個 DataStore 呼叫都要用 pcall 包起來,因為這類呼叫可能因為程式碼以外的原因失敗。如何安全地儲存,請參考 DataStore 教學。
Script 沒有錯誤卻什麼都不做
沉默的 Script 通常是根本沒有執行、還在等待某個東西,或是在錯誤的一邊執行。在修改程式碼之前,把 print(script:GetFullName(), "started") 放在第一行並執行遊戲。如果這一行始終沒有出現在 Output 中,問題就出在 Script 的位置或設定,而不是裡面寫了什麼。
| 要檢查的地方 | 出了什麼問題 | 修正方法 |
|---|---|---|
| Script 的類型與位置 | LocalScript 只有放在 StarterPlayerScripts、StarterCharacterScripts、StarterGui、StarterPack 或 ReplicatedFirst 中才會執行(放在 Starter 容器中時,是以玩家的副本執行)。放在 Workspace、ServerScriptService 或 ReplicatedStorage 中,它永遠不會執行。使用預設 RunContext 的 Script 只會在 Workspace 或 ServerScriptService 中執行。 | 把它移過去,或換一種 Script 類型。介面與操作的程式碼放在 LocalScript,遊戲規則放在 ServerScriptService 中的 Script。 |
| Enabled | 取消勾選 Enabled 的 Script 不會執行。 | 選取它,並在 Properties 視窗中勾選 Enabled。 |
| RunContext | Script 的 RunContext 決定它在哪裡執行。預設值 Legacy 會從 Workspace 或 ServerScriptService 在伺服器上執行。Server 在伺服器上執行,Client 則在每位玩家的裝置上執行,例如從 ReplicatedStorage。 | 有意識地設定它。Roblox 文件建議把 Client Script 放在 ReplicatedStorage 或 ReplicatedFirst,把 LocalScript 放在 Starter 容器中。 |
| 事件沒有觸發 | Touched 只會因物理移動而觸發,兩個零件中至少要有一個沒有固定,而且兩者都要開啟 CanTouch。對於在你連接事件時已經在伺服器上的玩家,PlayerAdded 不會觸發。如果另一邊從來沒有觸發事件,RemoteEvent 的處理函式也不會執行。 | 在處理函式裡放一個 print,確定它到底有沒有執行,再修正應該觸發它的地方。 |
| 迴圈或等待之後的程式碼 | while true do 迴圈下面的行永遠不會執行,因為迴圈不會結束。一直找不到物件的 WaitForChild 下面的行也不會執行。 | 在迴圈之前連接事件,或用 task.spawn 執行迴圈。替等待設定逾時時間。 |
| 默默結束的檢查 | 像 if not coins then return end 這樣的防護,在物件不存在時會默默停止函式。 | 在 return 之前加上帶有詳細資訊的 warn。 |
| Output 篩選器 | Output 可以依訊息類型、Client 或 Server 以及文字篩選。忘記關掉的篩選器可能會把你要找的錯誤藏起來。 | 重設篩選器並清空搜尋欄位。 |
| 只有你看得到 | 變更是 LocalScript 做的,所以只有這位玩家看得到。伺服器和其他玩家都看不到。 | 在伺服器上做這個變更。請參考 Script 在哪裡執行。 |
很多人都會踩到 PlayerAdded 的坑,因為在 Studio 測試中,你幾乎是在伺服器啟動後立刻加入。如果 Connect 那一行上面有東西在等待,例如 WaitForChild、task.wait,或 require 一個會等待的模組,你可能會在連接建立之前就加入。新加入和已經加入的玩家都要處理:
local Players = game:GetService("Players")
local function onPlayerAdded(player: Player)
print(`[Welcome] {player.Name} joined`)
end
Players.PlayerAdded:Connect(onPlayerAdded)
-- 對於上面那一行執行時就已經在這裡的玩家,
-- 這個 Script 中的 PlayerAdded 不會觸發,所以現在就處理他們
for _, player in Players:GetPlayers() do
task.spawn(onPlayerAdded, player)
end
Roblox Studio 的除錯工具
帶有上下文的 print 和 warn
print 會在 Output 寫一行文字,warn 則寫一則警告。這是回答「這到底有沒有執行?」和「這個值是多少?」最快的方法。單純的 print(x) 事後很難找到,所以請加上標籤和重要的細節。typeof(x) 會顯示值的類型:數字、字串、Instance 或 nil,GetFullName() 則會顯示你手上究竟是哪個物件。
local Players = game:GetService("Players")
local DEBUG = true -- 完成後設為 false
local TAG = "[ShopServer]"
local function debugPrint(...: any)
if DEBUG then
print(TAG, ...)
end
end
Players.PlayerAdded:Connect(function(player: Player)
debugPrint("joined:", player.Name, player.UserId)
local leaderstats = player:WaitForChild("leaderstats", 10)
if not leaderstats then
warn(TAG, "no leaderstats for", player.Name, "after 10 seconds")
return
end
local coins = leaderstats:FindFirstChild("Coins")
-- typeof 和 ClassName 會顯示這個值實際上是什麼
debugPrint("Coins is", typeof(coins), if coins then coins.ClassName else "missing")
end)
Output 的搜尋欄位會依文字篩選,所以像 [ShopServer] 這樣固定的標籤,可以讓你只顯示這個系統的訊息。如果需要知道程式碼是怎麼走到這一行的,debug.traceback() 會以字串回傳目前的呼叫堆疊。
中斷點與逐步執行
中斷點會讓遊戲在某一行暫停,讓你查看那一刻的所有狀態。在 Script Editor 中點擊行號右邊的邊欄(會出現紅色圓點),然後開始試玩測試。當執行走到這一行時,遊戲會暫停,黃色箭頭會指出下一行。接著用逐步執行按鈕在程式碼中前進:
- Step Over(F10)執行目前這一行,並停在下一行。
- Step Into(F11)進入這一行所呼叫的函式內部。
- Step Out(Shift+F11)把目前的函式執行完,並停在呼叫它的程式碼中。
- Resume Scripts 會繼續執行到下一個中斷點。
在邊欄按右鍵,還有兩種實用的類型。條件式中斷點只在像 amount < 0 這樣的運算式為真時暫停。Logpoint 會在不暫停的情況下在 Output 中印出訊息,所以不用修改 Script 就能記錄某個值。
Watch 與 Call Stack
遊戲暫停時,把滑鼠移到 Script Editor 中的變數上,就能看到它的值。Watch 視窗的 Variables 分頁會顯示作用範圍內的所有變數,在 My Watches 分頁則可以輸入任何運算式,例如 coins.Value + amount,並看到它目前的值。Call Stack 視窗會顯示是哪個函式呼叫了哪個函式,才走到暫停的那一行。兩者都可以從 Script 分頁或 Window 選單開啟。
Script Analysis 與嚴格模式
Script Editor 會在你輸入時就標出問題,而用 Script 分頁上的 Analysis 按鈕開啟的 Script Analysis 視窗,會列出所有 Script 的錯誤與警告。它能在按下 Play 之前抓到語法錯誤和不明的名稱。如果在 Script 的第一行放上 --!strict,就會開啟 Luau 的嚴格型別檢查,它還會回報屬性的拼字錯誤、參數型別錯誤,以及可能是 nil 的值。但它看不到執行中的遊戲:Workspace 中不存在的零件,只有 Output 會告訴你。
Command bar
Command bar(在 Script 分頁上,或按 Ctrl+9,Mac 上是 ⌘9)會立即執行 Luau。遊戲執行時,這是快速提問的方法:print(workspace:FindFirstChild("Bridge")) 會告訴你有沒有這個零件,print(#game:GetService("Players"):GetPlayers()) 則會算出玩家人數。在編輯模式下,command bar 中的程式碼會真的修改你的場景,所以對任何會移動或刪除物件的東西都要小心。
正式遊戲中的 Developer Console
Studio 的 Output 只在 Studio 中運作。在正式遊戲中,按下 F9 或在聊天中輸入 /console,就能開啟 Developer Console。它的 Log 會顯示你的裝置的輸出,如果你是遊戲擁有者或有權編輯遊戲的群組成員,也會顯示伺服器的輸出。
Roblox 內建的 Assistant 也能協助處理單一訊息:Roblox 自己的教學建議把 Output 中的錯誤貼上,請 Assistant 分析。如果 Assistant 不再回應,或說你已經達到上限,請參考 Assistant 的上限與錯誤。
用 RoCode 修正錯誤
RoCode 是獨立的 Roblox Studio AI 代理:你在網頁聊天中描述問題,Studio 外掛程式就會讀取並修改你開啟的場景。遇到錯誤時,它可以根據你已經執行過的試玩測試,接手上面步驟中的閱讀部分。
我按下 Play,點擊商店按鈕卻沒有任何反應。Output 顯示 attempt to index nil with 'Coins'。找出原因並修正。
- 用它的 Check Output 工具讀取 Studio 中的 Output,包括你上一次試玩測試的 Server 和 Client 訊息,即使你已經按下 Stop 也一樣
- 透過 Read Script 開啟錯誤中的 Script 並讀取那一行周圍的程式碼,也能透過 Search Scripts 找出缺少的值原本應該在哪裡建立
- 透過 Edit Script 做精準的修改,也就是在那個 Script 中精確地搜尋並取代,接著執行 Check Script,在 Studio 內編譯這個 Script(它不檢查型別、不執行 linter,也不會執行你的程式碼)
- 分批把變更送到 Studio,每一批都是 Studio 紀錄中的一個復原點
再按一次 Play 並點擊商店按鈕,親自確認已經修好:使用 3.9 或更新版本的外掛程式時,RoCode 可以執行簡短的試玩測試並讀取錯誤,使用 3.9.15 或更新版本的外掛程式時,它的測試角色還能按畫面上的按鈕,但它只會檢查自己決定要測試的部分,而編譯檢查也無法告訴你遊戲邏輯是否正確。讀取錯誤是每次建置的一部分:整款遊戲的建置、檢查與測試循環會在每個系統完成後重複這項檢查。RoCode 如何連接到 Studio。
常見問題
為什麼 Roblox 的 Script 沒有錯誤卻不運作?
通常是 Script 根本沒有執行(Script 類型或容器不對,或是關閉了 Enabled)、它還在等待某個東西,或是它監聽的事件從來沒有觸發。在第一行放一個 print,就能看出是哪一種。請參考上面的檢查清單。
Roblox 的「attempt to index nil」是什麼意思?
點或冒號前面的值是 nil,所以 Roblox 無法看進它裡面。在 player.Character.Humanoid 這一行,錯誤 attempt to index nil with 'Humanoid' 代表 player.Character 是 nil:它不存在或還沒載入。使用前先用 if 檢查值,在 LocalScript 中則用 WaitForChild 等待伺服器建立的物件。原因的詳細說明。
Roblox 的「infinite yield possible」是什麼意思?
WaitForChild 已經等待一個始終沒有出現的子物件超過 5 秒,而且還在繼續等。通常是名稱或父物件錯誤,或是沒有東西建立這個物件。原因的詳細說明。
為什麼 Output 視窗是空的或沒有顯示?
從 Window 選單或 Script 分頁開啟它。如果它開著,但測試時一直是空的,請重設篩選器和搜尋欄位,再確認應該印出東西的 Script 有在執行。
Roblox 有檢查 Script 錯誤的功能嗎?
有,它內建在 Studio 中:Script Editor 會在你輸入時標出問題,Script Analysis 視窗則會以清單列出它們。它們能找到語法錯誤和型別錯誤,但找不到不存在的物件或錯誤的遊戲邏輯:這些只有在程式碼執行時才看得出來。
需要用 pcall 把程式碼包起來避免錯誤嗎?
只有可能因為程式碼以外的原因失敗的呼叫才需要,例如 DataStore 請求、HTTP 或 MarketplaceService。如果用 pcall 包住 nil 的錯誤,訊息會消失,但函式還是不會運作。
如何查看正式遊戲中的 Script 錯誤?
在遊戲中按下 F9,或在聊天中輸入 /console,開啟 Developer Console。它會顯示你的裝置上的錯誤,如果你是遊戲擁有者或可以編輯遊戲的群組成員,也會顯示伺服器的錯誤。
來源與延伸閱讀
- Roblox Creator Docs:Output(英文). Output 的位置、篩選器與顯示設定
- Roblox Creator Docs:Debugging(英文). 中斷點、逐步執行、Watch、Call Stack、command bar 與 Developer Console
- Roblox Creator Docs:Script Editor(英文). Script Analysis 視窗
- Roblox Creator Docs:Studio interface(英文). Output 和 command bar 從哪裡開啟
- Roblox Creator Docs:Script types and locations(英文). 每種 Script 類型在哪裡執行,以及 RunContext
- Roblox Creator Docs:Studio testing modes(英文). Play、Client 與 Server 檢視,以及 Server & Clients 測試
- Roblox Engine API:Instance(英文). WaitForChild、它的逾時時間與 5 秒後的警告
- Roblox Creator Docs:Reuse code(英文). ModuleScript 與遞迴 require
- Roblox Creator Docs:Data store error codes and limits(英文). 403 錯誤,StudioAccessToApisNotAllowed
- Roblox Creator Docs:Data stores(英文). 開啟 Studio 存取權,以及另外的測試副本
- Roblox Engine API:BasePart(英文). Touched 什麼時候觸發,以及 CanTouch
- Roblox Creator Docs:Type checking(英文). 嚴格模式
- Roblox Creator Docs:Developer Console(英文). 正式遊戲中誰能看到伺服器的輸出
- Roblox Creator Docs:Build your first game with Assistant(英文). 把 Output 中的錯誤貼上,讓 Assistant 分析
程式碼如何驗證:本頁每一段 Script 都通過 Luau 嚴格型別檢查,並使用 Roblox API 定義(luau-lsp,2026年11月20日)。型別檢查能找出拼錯的 API 與錯誤的型別,但無法檢查遊戲邏輯,所以發布前請先在 Studio 中測試。