教程 · 调试

Roblox Studio 脚本错误怎么修复

Roblox 里的脚本出问题时,Studio 通常会在 Output 窗口里告诉你出错的位置和原因。本教程讲解怎么读这条信息,常见错误是什么意思以及怎么逐个修复,脚本完全不报错却不工作时该检查什么,以及一套找出原因而不是靠猜的排查步骤。

更新于 2026年11月20日阅读约 5 分钟作者

要点

通过 Window 菜单或 Script 标签页打开 Output 窗口,点击 Play,然后点击第一条红色错误。Studio 会打开脚本并跳到出错的那一行。信息会说明哪里出了问题:attempt to index nil with 'Humanoid' 表示紧挨在 .Humanoid 前面的值是 nil。修复这个值不存在的原因,然后重新运行游戏。

  • 从列表里的第一条错误开始。下面的错误往往只是它的连锁结果。
  • 游戏运行时的常见错误归结为三个原因:值是 nil,名字写错或还没加载,或者代码运行在错误的一端(服务器或客户端)。
  • 如果完全没有错误,通常是代码根本没有运行。检查脚本类型、它在 Explorer 中的位置、它的 Enabled 属性,以及它等待的事件到底有没有触发。
  • 要知道某一行上的值实际是什么,用带标签的 print 输出它,或者在这一行设一个断点。
本页内容
  1. 读懂 Output
  2. 调试步骤
  3. 常见错误
  4. 不报错也没反应
  5. 调试工具
  6. 使用 RoCode
  7. 常见问题
  8. 参考资料

怎么打开 Output 并读懂错误

示意教程里的致死方块示例,已加速:出错的那一行报错,停止、修复并重新试玩后,零件掉落不再报错。

Output 窗口是 Roblox 报告脚本错误、引擎警告以及你的代码输出的所有内容的地方。它不总是打开的,所以请在测试前打开它。如果你还从没运行过脚本,Roblox 脚本入门教程 一开始就会打开 Output,并从脚本中输出第一行内容。

  1. 通过 Studio 的 Window 菜单或 Script 标签页上的按钮打开 Output。
  2. 用 Ctrl+K(Mac 上是 ⌘K)清除旧信息,这样只看得到这次测试的内容。
  3. 点击 Play(F5),然后做那件会让游戏出问题的事。
  4. 找到第一条红色的行。错误是红色的。警告,例如 Infinite yield possible,显示为橙色。

游戏运行时 Output 里的错误长这样。根据 Output 的显示设置,每一行可能还带有时间、Client 或 Server 标记以及脚本名。

Output(示例)
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 是脚本在 Explorer 中的位置:ServerScriptService 里一个名为 CoinPad 的脚本。
  • :14 是出错的行号。
  • 行号后面的信息说明哪里出了问题。每一种都在下面的 常见错误列表 中讲解。
  • Stack Begin 和 Stack End 之间的调用栈显示了走到这里的调用过程,从最近的一个开始:award 函数里的第 14 行,而这个函数是从第 27 行调用的。

点击红色错误,Studio 会打开这个脚本,光标停在对应的行上。在单人测试中,服务器和你的客户端的信息都进入同一个 Output:服务器的标为绿色,客户端的标为蓝色。顶部的筛选器可以按信息类型(Error、Warning)、按上下文(Client、Server)或按文字缩小列表。

适用于任何脚本的调试步骤

靠猜并一次改好几处,是修脚本最慢的方法。不管有没有错误信息,这套步骤都会一步步缩小问题范围。

  1. 重现问题。清空 Output,点击 Play,准确地做那件让游戏出问题的事。记下你期望发生什么,以及实际发生了什么。
  2. 抓住第一条错误。读第一条新的红色行:脚本路径、行号和信息。如果没有错误,转到 不报错却不工作的脚本 部分。
  3. 跳到那一行。点击错误。读完整行,问自己这一行里哪个值可能是 nil、名字写错了,或者类型不对。
  4. 检查值,而不是猜。在这一行正上方加一个 print,或者在这一行设一个 断点,在 Watch 窗口里看值。typeof(x) 会告诉你它是数字、字符串、Instance 还是 nil。
  5. 顺着线索往回找。如果值不对,找到它被赋值的地方:什么都没找到的 FindFirstChild,什么都没返回的函数,调用方根本没传的参数。
  6. 修复原因,一次只改一处。改正名字,等待对象,或者把代码移到正确的一端,然后重新运行游戏。不要用 pcall 包住这一行让它闭嘴:这只会把 bug 藏起来,而不是修好它。
  7. 确认。重复第 1 步。错误应该消失,功能也应该按你的预期工作。如果涉及其他玩家,再在 Server & Clients 模式下用两个客户端测试。
  8. 收拾干净。删除或关闭调试用的 print,这样下一个问题更容易被发现。

Roblox 常见脚本错误及修复方法

每条信息都按同一个模板生成,只是填入了你的名字,所以错误文字本身就是最好的提示。下面引号里的名字,例如 'Health' 或 "Workspace",都只是示例。

Output 中的常见错误。选择一条信息查看完整解释。
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,对文字使用 tonumber。
attempt to concatenate string with nil.. 试图把文字和 nil 或对象拼在一起。使用 tostring()、.Name 或字符串插值。
Expected 'end' (to close 'function' at line 3), got <eof>语法错误。脚本根本不会运行。修复 Script Editor 里红色下划线标出的地方。
Requested module experienced an error while loadingModuleScript 本身在运行时出错了。修复模块自己的错误,它显示在 Output 里稍微往上一点的位置。
Argument 1 missing or nilRoblox 函数在需要值的地方收到了 nil。追查这个参数本应从哪里来。
FireServer can only be called from the client在错误的一端调用了 RemoteEvent。服务器用 FireClient,LocalScript 用 FireServer。
数据存储错误 403,StudioAccessToApisNotAllowedStudio 没有被允许使用这个游戏的数据存储。发布游戏并开启 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'

索引就是通过点号或方括号读取某个东西: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],或者调用的函数什么都没返回。

经典案例是致死方块。出错的版本以为碰到零件的东西都属于某个角色,但对于丢下的工具、未锚定的零件和饰品来说并不是这样。

Script 位置: Workspace 中的 Part 名称: KillBrick
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,因为它可能在脚本运行之后才出现。

Infinite yield possible on ...

WaitForChild("Name") 会让脚本暂停,直到出现一个这个名字的子对象。如果它等了超过 5 秒,而你没有设置超时,Roblox 就会输出这条警告。这是警告,不是错误:脚本还在等,这一行之后的代码在对象出现之前都不会运行,而对象可能永远不会出现。常见原因:

  • 名字或父对象不对。WaitForChild("leaderStats") 永远找不到 leaderstats 文件夹。
  • 没有东西在创建这个对象:创建它的服务端脚本被关闭了、放错了位置,或者之前就出错了。在 Output 里找更早的错误。
  • LocalScript 在等 ServerStorage 或 ServerScriptService 里的东西。它们的内容永远不会发送给玩家,所以这个等待永远不会结束。
  • 你在等的是属性而不是子对象。常见例子是 player:WaitForChild("Character"):Character 是 Player 的属性,而不是它里面的对象。
  • 开启了实例流式传输(Workspace.StreamingEnabled),而零件离玩家太远,还没有发送给这个客户端。
LocalScript 位置: StarterPlayerScripts 名称: DeathMessage
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 的第二个参数是以秒为单位的超时时间。这样脚本就能用 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。
LocalScript 位置: StarterPlayerScripts 名称: CoinsWatcher
local Players = game:GetService("Players")

local player = Players.LocalPlayer

-- 出错的版本:
--   local coins = player.leaderstats.Coins
-- leaderstats 由服务器创建,可能在这个脚本运行之后
-- 才到达这个客户端。这时 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)

这里需要一个服务端脚本,创建带有名为 Coins 的 IntValue 的 leaderstats,就像 排行榜教程 里那样。

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:你在对值对象做运算,而不是对它的数字。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,所以信息里的顺序可能和你的代码相反。

Script 位置: ServerScriptService 名称: CoinDrip
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 而不是让脚本停下。

Expected 'end' 和其他语法错误

以 Expected 开头的信息是语法错误:代码不是正确的 Luau,Roblox 无法编译它,这个脚本的任何一行都不会运行,包括错误上面的行。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

第一次 require() 一个 ModuleScript 时会运行它的代码。如果模块运行时出错,引入它的脚本就会收到这条信息。真正的问题是模块自己的错误,在 Output 里往上一两行:修复那个错误。两条相似的信息:

  • Module code did not return exactly one value:模块没有以 return 结尾。ModuleScript 必须返回一个不是 nil 的值,通常是它的表。
  • Requested module was required recursively:两个模块互相引入。把共用的部分拆到第三个模块里,让两者都引入它。
ModuleScript 位置: ReplicatedStorage 名称: Format
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

脚本通过 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、LocalScript 和 ModuleScript。

Studio 中的数据存储 403 错误

在你允许之前,Studio 里的数据存储调用会以错误码 403(StudioAccessToApisNotAllowed)失败。发布场景,打开 File、Experience Settings、Security,开启 Enable Studio Access to API Services 并保存。之后 Studio 使用的数据存储和正式游戏是同一份,所以 Roblox 建议在单独的测试副本里做这件事,而不是在已经有人玩的游戏里。把每个数据存储调用都包在 pcall 里,因为这些调用可能因为你代码之外的原因失败。怎样安全地保存,见 DataStore 教程。

脚本不报错,却什么都不做

一个沉默的脚本通常是根本没运行、还在等什么东西,或者运行在错误的一端。在改代码之前,把 print(script:GetFullName(), "started") 放在它的第一行,然后运行游戏。如果这一行始终没有出现在 Output 里,问题出在脚本的位置或设置,而不是它里面写的内容。

脚本为什么可能不报错却什么都不做
检查什么哪里出了问题怎么修复
脚本类型和位置LocalScript 只有放在 StarterPlayerScripts、StarterCharacterScripts、StarterGui、StarterPack 或 ReplicatedFirst 里才会运行(在 Starter 容器中,它作为玩家的副本运行)。放在 Workspace、ServerScriptService 或 ReplicatedStorage 里,它永远不会运行。默认 RunContext 的 Script 只在 Workspace 或 ServerScriptService 中运行。把它移走,或者换一种脚本类型。界面和操控代码放在 LocalScript 里,游戏规则放在 ServerScriptService 里的 Script 中。
Enabled取消勾选 Enabled 的脚本不会运行。选中它,在 Properties 窗口里勾选 Enabled。
RunContextScript 的 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 做的,所以只有这个玩家能看到。服务器和其他玩家看不到。在服务器上做修改。见 脚本在哪里运行。

很多人都会在 PlayerAdded 上踩坑,因为在 Studio 测试中你几乎在服务器启动后马上就进入了。如果 Connect 那一行上面有东西在等待,例如 WaitForChild、task.wait 或者 require 一个会等待的模块,你就可能在连接建立之前进入游戏。新玩家和已经进入的玩家都要处理:

Script 位置: ServerScriptService 名称: Welcome
local Players = game:GetService("Players")

local function onPlayerAdded(player: Player)
	print(`[Welcome] {player.Name} joined`)
end

Players.PlayerAdded:Connect(onPlayerAdded)

-- 对于上面那一行运行时已经在这里的玩家,
-- 这个脚本里的 PlayerAdded 不会触发,所以现在处理他们
for _, player in Players:GetPlayers() do
	task.spawn(onPlayerAdded, player)
end

Roblox Studio 中的调试工具

print 往 Output 写一行,warn 写一条警告。这是回答“这到底运行了没有?”和“这个值是什么?”最快的方法。单纯的 print(x) 之后很难找到,所以要加上标签和重要的细节。typeof(x) 显示值是什么:数字、字符串、Instance 还是 nil,而 GetFullName() 显示你拿到的到底是哪个对象。

Script 位置: ServerScriptService 名称: ShopDebug
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 中输出一条信息而不暂停,所以不用修改脚本就能记录一个值。

Watch 和 Call Stack

游戏暂停时,把鼠标悬停在 Script Editor 里的变量上就能看到它的值。Watch 窗口的 Variables 标签页显示作用域内的所有变量,在 My Watches 标签页里可以输入任意表达式,例如 coins.Value + amount,并看到它当前的值。Call Stack 窗口显示是哪个函数调用了哪个函数,才走到暂停的那一行。两者都通过 Script 标签页或 Window 菜单打开。

Script Analysis 和严格模式

Script Editor 在你输入时就会标出问题,而通过 Script 标签页上的 Analysis 按钮打开的 Script Analysis 窗口会显示所有脚本的错误和警告。它能在点击 Play 之前发现语法错误和未知的名字。如果在脚本第一行写上 --!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'。找出原因并修复。

RoCode 的操作
  • 用自己的 Check Output 工具读取 Studio 里的 Output,包括你上一次试玩测试的 Server 和 Client 行,即使你已经点击了 Stop
  • 用 Read Script 打开错误里的脚本并读取那一行周围的代码,还能用 Search Scripts 找到缺失的值本应在哪里创建
  • 用 Edit Script 做精确修改,也就是在这个脚本里精确查找和替换,然后运行 Check Script,在 Studio 内编译脚本(它不检查类型,不运行 linter,也不执行你的代码)
  • 把修改分批发送到 Studio,每一批都是 Studio 历史中的一个撤销点

再点一次 Play 并点击商店按钮,亲自确认已修复:插件 3.9 及以上 RoCode 可以运行简短的试玩测试并读取错误,插件 3.9.15 及以上它的测试角色可以点击屏幕上的按钮,但它只检查自己决定测试的内容,而编译检查无法告诉你游戏逻辑是否正确。读取错误是每次构建的一部分:整个游戏的构建、检查和测试循环 会在每个系统之后重复这项检查。RoCode 如何连接 Studio。

常见问题

Roblox 脚本没有报错,为什么不工作?

通常是脚本根本没运行(脚本类型或容器不对,或者关闭了 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 标签页打开它。如果它开着,但测试时一直是空的,重置筛选器和搜索框,然后检查本应输出内容的脚本是否在运行。

Roblox 有检查脚本错误的工具吗?

有,它内置在 Studio 里:Script Editor 在你输入时标出问题,Script Analysis 窗口以列表形式显示它们。它们能找出语法错误和类型错误,但找不出缺失的对象或错误的游戏逻辑:这些只有代码运行时才能看到。

要不要用 pcall 包住代码来避免报错?

只包住那些可能因为你代码之外的原因失败的调用,例如数据存储请求、HTTP 或 MarketplaceService。如果用 pcall 包住 nil 错误,信息会消失,但功能仍然不会工作。

怎么在正式游戏中查看脚本错误?

在游戏中按 F9 或在聊天里输入 /console,打开 Developer Console。它显示你设备上的错误,如果你是游戏的所有者或能编辑它的群组成员,还会显示服务器上的错误。

参考资料

代码如何验证:本页的所有脚本都已用 Roblox API 类型定义(luau-lsp,2026年11月20日)通过 Luau strict 类型检查。类型检查能发现 API 名称写错和类型不匹配,但发现不了游戏逻辑上的错误。发布前请务必在 Studio 中测试。

在你自己的游戏里试试 RoCode。

每天有免费额度,无需绑定银行卡。安装插件,描述你想要的功能,然后看看它在 Studio 里做了什么。