Panduan · Debugging

Cara membaiki ralat skrip dalam Roblox Studio

Apabila skrip dalam Roblox rosak, Studio biasanya menulis di mana dan mengapa dalam tetingkap Output. Panduan ini menerangkan cara membaca mesej itu, maksud ralat yang biasa dan cara membaiki setiap satu, apa yang perlu disemak jika skrip langsung tidak berfungsi tanpa sebarang ralat, dan urutan langkah yang mencari punca sebenar dan bukannya meneka.

Dikemas kini 20 November 202618 minit bacaanDitulis oleh

Ringkasnya

Buka tetingkap Output melalui menu Window atau tab Script, tekan Play dan klik ralat merah yang pertama. Studio akan membuka skrip pada baris di mana ia gagal. Mesej itu memberitahu apa yang salah: attempt to index nil with 'Humanoid' bermaksud nilai betul-betul sebelum .Humanoid ialah nil. Baiki sebab nilai itu tiada, dan jalankan game sekali lagi.

  • Mulakan dengan ralat pertama dalam senarai. Ralat di bawahnya selalunya hanya akibat daripadanya.
  • Ralat biasa semasa permainan bermula daripada tiga punca: nilai ialah nil, nama tersalah eja atau belum dimuatkan, atau kod berjalan di sisi yang salah (pelayan atau client).
  • Jika langsung tiada ralat, biasanya kod itu tidak pernah berjalan. Semak jenis skrip, di mana ia terletak dalam Explorer, property Enabled dan sama ada event yang ditunggunya benar-benar berlaku.
  • Untuk mengetahui nilai sebenar pada baris tertentu, cetak nilai itu dengan print berlabel atau letakkan breakpoint pada baris itu.
Di halaman ini
  1. Membaca Output
  2. Urutan debugging
  3. Ralat biasa
  4. Tiada ralat, tiada apa berlaku
  5. Alat debugging
  6. Dengan RoCode
  7. Soalan lazim
  8. Sumber dan bacaan lanjut

Cara membuka Output dan membaca ralat

IlustrasiContoh kill brick daripada panduan, dipercepatkan: baris yang rosak menghasilkan ralat, dan selepas Stop, pembaikan dan playtest baharu, part jatuh tanpa ralat.

Tetingkap Output ialah tempat Roblox melaporkan ralat skrip, amaran enjin dan semua yang dicetak oleh kod anda. Ia tidak sentiasa terbuka, jadi bukanya sebelum ujian. Jika anda belum pernah menjalankan skrip, panduan skrip untuk pemula bermula dengan membuka Output dan mencetak baris pertama daripada skrip.

  1. Buka Output melalui menu Window dalam Studio atau butang pada tab Script.
  2. Kosongkan mesej lama dengan Ctrl+K (⌘K pada Mac), supaya anda hanya melihat ujian ini.
  3. Tekan Play (F5) dan lakukan perkara yang merosakkan game.
  4. Cari baris merah yang pertama. Ralat berwarna merah. Amaran, contohnya Infinite yield possible, dipaparkan dalam warna jingga.

Beginilah rupa ralat semasa permainan dalam Output. Bergantung pada tetapan paparan Output, setiap baris mungkin juga ada masa, label Client atau Server dan nama skrip.

Output (contoh)
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 ialah lokasi skrip dalam Explorer: skrip bernama CoinPad di dalam ServerScriptService.
  • :14 ialah baris di mana ralat berlaku.
  • Mesej selepas nombor baris memberitahu apa yang salah. Setiap satu diterangkan dalam senarai ralat biasa di bawah.
  • Stack antara Stack Begin dan Stack End menunjukkan panggilan yang membawa ke sini, bermula dengan yang terakhir: baris 14 di dalam fungsi award, yang dipanggil dari baris 27.

Klik ralat merah, dan Studio akan membuka skrip itu dengan kursor pada baris yang betul. Dalam ujian solo, mesej pelayan dan client anda masuk ke Output yang sama: mesej pelayan ditanda hijau, mesej client biru. Penapis di bahagian atas menyempitkan senarai mengikut jenis mesej (Error, Warning), konteks (Client, Server) atau teks.

Urutan debugging yang sesuai untuk mana-mana skrip

Meneka dan menukar beberapa perkara sekaligus ialah cara yang perlahan untuk membaiki skrip. Urutan ini menyempitkan masalah langkah demi langkah, sama ada terdapat mesej ralat atau tidak.

  1. Ulang masalah itu. Kosongkan Output, tekan Play dan lakukan tepat perkara yang merosakkan game. Catat apa yang anda jangkakan dan apa yang berlaku sebaliknya.
  2. Ambil ralat pertama. Baca baris merah baharu yang pertama: laluan skrip, nombor baris dan mesej. Jika tiada ralat, pergi ke bahagian skrip yang berjalan tanpa ralat.
  3. Pergi ke baris itu. Klik ralat. Baca seluruh baris dan tanya diri sendiri nilai mana di dalamnya yang mungkin nil, tersalah eja atau jenisnya salah.
  4. Semak nilai, jangan meneka. Tambah print betul-betul di atas baris itu atau letakkan breakpoint padanya dan lihat nilai dalam tetingkap Watch. typeof(x) memberitahu apa yang anda ada: nombor, string, Instance atau nil.
  5. Jejak ke belakang. Jika nilai salah, cari di mana ia ditetapkan: FindFirstChild yang tidak menemui apa-apa, fungsi yang tidak memulangkan apa-apa, argumen yang tidak pernah dihantar oleh kod pemanggil.
  6. Baiki punca, satu perubahan pada satu masa. Betulkan nama, tunggu objek atau pindahkan kod ke sisi yang betul, kemudian jalankan game sekali lagi. Jangan bungkus baris itu dalam pcall supaya ia senyap: dengan cara itu pepijat disembunyikan, bukan dibaiki.
  7. Pastikan. Ulang langkah 1. Ralat sepatutnya hilang, dan ciri itu sepatutnya melakukan apa yang anda jangkakan. Jika ia melibatkan pemain lain, uji juga dalam mod Server & Clients dengan dua client.
  8. Kemaskan. Padam atau matikan print debugging, supaya masalah seterusnya mudah dikesan.

Ralat skrip Roblox yang biasa dan cara membaikinya

Setiap mesej dibina mengikut satu templat yang diisi dengan nama anda, jadi teks ralat itu sendiri ialah petunjuk terbaik. Nama dalam tanda petik di bawah, contohnya 'Health' atau "Workspace", hanyalah contoh.

Ralat biasa dalam Output. Pilih mesej untuk membuka penerangan penuh.
Apa yang ditulis OutputMaksudnyaCara biasa membaikinya
attempt to index nil with 'Health'Nilai sebelum .Health ialah nil.Ketahui mengapa ia nil, dan semak dengan if sebelum menggunakannya.
Infinite yield possible on 'Players.YourName:WaitForChild("Character")'WaitForChild sudah menunggu selama 5 saat, dan objek itu masih belum muncul.Betulkan nama atau laluan, pastikan ada yang mencipta objek itu, atau tambah had masa.
Bridge is not a valid member of Workspace "Workspace"Objek anak atau property dengan nama tepat itu tiada di situ sekarang.Bandingkan ejaan dan huruf besar dengan Explorer. Pada client, gunakan WaitForChild.
attempt to call a nil valueAnda memanggil sesuatu yang bukan fungsi.Semak nama fungsi dan pastikan ia diisytiharkan di atas panggilan.
attempt to perform arithmetic (add) on Instance and numberMatematik dengan sesuatu yang bukan nombor.Gunakan .Value pada objek value dan tonumber untuk teks.
attempt to concatenate string with nil.. cuba menyambung teks dengan nil atau objek.Gunakan tostring(), .Name atau interpolasi string.
Expected 'end' (to close 'function' at line 3), got <eof>Ralat sintaks. Skrip langsung tidak berjalan.Baiki apa yang digaris merah dalam Script Editor.
Requested module experienced an error while loadingModuleScript itu sendiri gagal dengan ralat semasa berjalan.Baiki ralat modul itu sendiri, yang dipaparkan sedikit di atas dalam Output.
Argument 1 missing or nilFungsi Roblox menerima nil di tempat ia memerlukan nilai.Jejak dari mana argumen itu sepatutnya datang.
FireServer can only be called from the clientRemoteEvent dipanggil dari sisi yang salah.Pelayan menggunakan FireClient, LocalScript menggunakan FireServer.
Ralat data store 403, StudioAccessToApisNotAllowedStudio tidak dibenarkan menggunakan data store game ini.Terbitkan game dan hidupkan Studio Access to API Services.

Setiap mesej di sini, dan banyak lagi, mempunyai halaman sendiri dengan setiap punca, kod yang menyebabkannya dan pembaikannya: lihat mesej ralat Roblox Studio, contohnya attempt to index nil, Infinite yield possible dan is not a valid member of.

attempt to index nil with 'X'

Indexing ialah membaca sesuatu melalui titik atau kurungan segi empat: part.Position, player.Character, list[1]. Ralat ini memberitahu bahawa apa yang di sebelah kiri ialah nil, dan nama dalam tanda petik ialah apa yang anda cuba baca daripadanya. Jadi, pada baris player.Character.Humanoid, ralat attempt to index nil with 'Humanoid' bermaksud player.Character ialah nil. Jika kuncinya nombor, mesej berakhir dengan with number.

Sebab biasa nilai itu nil:

  • FindFirstChild, FindFirstChildOfClass atau FindFirstAncestor tidak menemui apa-apa, kerana namanya berbeza atau objek itu belum wujud.
  • Players.LocalPlayer digunakan dalam Script pelayan. Ia hanya wujud dalam LocalScript dan dalam ModuleScript yang dimuatkan olehnya melalui require; pada pelayan ia sentiasa nil. Gunakan player yang diberikan oleh PlayerAdded atau pengendali RemoteEvent sebagai gantinya.
  • player.Character dibaca sebelum watak muncul (spawn), atau semasa ia sedang respawn.
  • Entri dalam jadual tidak pernah ditetapkan, contohnya playerData[player] sebelum data pemain itu dimuatkan, atau fungsi yang dipanggil tidak memulangkan apa-apa.

Kes klasik ialah kill brick. Versi yang rosak menganggap semua yang menyentuh part itu milik watak, sedangkan untuk alat yang dibuang, part yang tidak diikat dan aksesori, itu tidak benar.

Script dalam Part dalam Workspace bernama KillBrick
local part = script.Parent :: BasePart

part.Touched:Connect(function(hit: BasePart)
	-- Versi yang rosak:
	--   hit.Parent:FindFirstChild("Humanoid").Health = 0
	-- Jika part yang menyentuh bukan sebahagian badan watak, FindFirstChild
	-- memulangkan nil, dan Output menunjukkan:
	--   attempt to index nil with 'Health'

	-- Sudah dibaiki: semak setiap langkah sebelum menggunakannya
	local model = hit:FindFirstAncestorOfClass("Model")
	local humanoid = model and model:FindFirstChildOfClass("Humanoid")
	if humanoid then
		humanoid.Health = 0
	end
end)

Jika anda menulis hit.Parent.Humanoid, mesejnya berbeza, Humanoid is not a valid member of ..., yang diterangkan di bawah. FindFirstAncestorOfClass("Model") menemui watak walaupun part yang menyentuh berada di dalam aksesori atau alat di tangan watak, jadi alat di tangan yang mengenai blok itu juga dikira.

Corak yang membaiki ralat ini: dapatkan nilai, semak, dan barulah gunakannya. Pada pelayan, FindFirstChild dengan semakan if sesuai untuk perkara yang mungkin memang tiada. Dalam LocalScript, gunakan WaitForChild untuk perkara yang dicipta oleh pelayan, kerana ia mungkin muncul selepas skrip bermula.

Infinite yield possible on ...

WaitForChild("Name") menjeda skrip sehingga objek anak dengan nama itu muncul. Jika ia menunggu lebih daripada 5 saat dan anda tidak menetapkan had masa, Roblox mencetak amaran ini. Ia amaran, bukan ralat: skrip masih menunggu, dan tiada apa-apa selepas baris ini akan berjalan sehingga objek itu muncul, dan itu mungkin tidak berlaku langsung. Sebab biasa:

  • Nama atau parent salah. WaitForChild("leaderStats") tidak akan pernah menemui folder leaderstats.
  • Tiada siapa mencipta objek itu: skrip pelayan yang membuatnya dimatikan, berada di tempat yang salah atau gagal dengan ralat lebih awal. Cari ralat yang lebih awal dalam Output.
  • LocalScript menunggu sesuatu dalam ServerStorage atau ServerScriptService. Kandungannya tidak pernah dihantar kepada pemain, jadi penantian itu tidak akan berakhir.
  • Anda menunggu property, bukan objek anak. Contoh biasa ialah player:WaitForChild("Character"): Character ialah property Player, bukan objek di dalamnya.
  • Penstriman objek dihidupkan (Workspace.StreamingEnabled), dan part itu terlalu jauh daripada pemain, jadi ia belum dihantar kepada client ini.
LocalScript dalam StarterPlayerScripts bernama DeathMessage
local Players = game:GetService("Players")

local player = Players.LocalPlayer

-- Versi yang rosak:
--   local character = player:WaitForChild("Character")
-- Character ialah property Player, bukan objek anak, jadi Output memberi amaran:
--   Infinite yield possible on 'Players.YourName:WaitForChild("Character")'

local function onCharacterAdded(character: Model)
	-- Dengan had masa, WaitForChild memulangkan nil dan tidak menunggu selama-lamanya
	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

-- Uruskan watak yang mungkin sudah wujud, kemudian setiap respawn
local current = player.Character
if current then
	onCharacterAdded(current)
end
player.CharacterAdded:Connect(onCharacterAdded)

Nombor sebagai argumen kedua WaitForChild ialah had masa dalam saat. Dengan itu skrip boleh melaporkan masalah melalui warn dan berhenti dengan kemas, dan bukannya tergantung secara senyap.

X is not a valid member of Y

Anda menggunakan titik untuk mengakses objek anak atau property yang tiada pada masa itu, contohnya workspace.Bridge apabila Workspace tiada part bernama Bridge. Mesej itu mula-mula menyebut apa yang anda minta, kemudian kelas dan laluan penuh objek tempat ia dicari. Semak tiga perkara:

  • Ejaan dan huruf besar sepadan tepat dengan Explorer. Folder itu bernama leaderstats, semuanya huruf kecil, dan humanoid bukan Humanoid.
  • Nama property menggunakan ejaan Amerika. part.Colour gagal dengan Colour is not a valid member of Part "Workspace.Part"; property itu bernama Color.
  • Objek itu sudah dimuatkan. Pada client, objek yang dicipta oleh pelayan mungkin tiba selepas LocalScript bermula, jadi gunakan WaitForChild di situ.
LocalScript dalam StarterPlayerScripts bernama CoinsWatcher
local Players = game:GetService("Players")

local player = Players.LocalPlayer

-- Versi yang rosak:
--   local coins = player.leaderstats.Coins
-- leaderstats dicipta oleh pelayan, dan ia mungkin sampai ke client ini selepas
-- skrip ini bermula. Kemudian Output menunjukkan:
--   leaderstats is not a valid member of Player "Players.YourName"

local leaderstats = player:WaitForChild("leaderstats")
local coins = leaderstats:WaitForChild("Coins") :: IntValue -- pelayan membuat Coins sebagai IntValue

print(`[CoinsWatcher] starting coins: {coins.Value}`)
coins.Changed:Connect(function(newValue: number)
	print(`[CoinsWatcher] coins changed to {newValue}`)
end)

Di sini anda perlukan skrip pelayan yang mencipta leaderstats dengan IntValue bernama Coins, seperti dalam panduan leaderboard.

attempt to call a nil value

Kod meletakkan kurungan selepas sesuatu yang bernilai nil, jadi tiada apa-apa untuk dijalankan. Sebab biasa:

  • Nama fungsi tersalah eja atau berbeza huruf besarnya. Modul mengisytiharkan Format.clock, tetapi kod pemanggil menulis Format.Clock(95).
  • local function dipanggil pada baris di atas pengisytiharannya. Pada masa itu nama itu belum wujud, jadi pindahkan pengisytiharan ke atas.
  • ModuleScript tidak pernah menambah fungsi itu ke dalam jadual yang dipulangkannya.

Dua mesej yang serupa menunjukkan kesilapan yang sama. Memanggil method jadual yang tidak wujud melalui titik bertindih memberi attempt to call missing method 'Kill' of table. Salah taip dalam method objek Roblox, contohnya part:Destory(), memberi Destory is not a valid member of Part "Workspace.Part".

attempt to perform arithmetic (add) on ...

Luau cuba mengira (add, sub, mul, div dan sebagainya), tetapi salah satu sisi bukan nombor. Nama jenis di hujung mesej memberi petunjuk kes yang anda hadapi:

  • on Instance and number: anda mengira dengan objek value, bukan dengan nombornya. coins + 10 sepatutnya coins.Value + 10.
  • on nil and number: pemboleh ubah atau entri jadual tidak pernah ditetapkan. Beri nilai permulaan, atau tulis (x or 0) di tempat ketiadaan nilai memang bermaksud sifar.
  • on string and number: teks yang bukan nombor, selalunya daripada TextBox. Tukarkannya dengan tonumber(text) dan semak bahawa hasilnya bukan nil. Teks yang mengandungi nombor, contohnya "5", ditukar secara automatik.

Perbandingan gagal dengan cara yang sama, dengan attempt to compare nil < number. Luau menulis semula a > b sebagai b < a, jadi susunan dalam mesej mungkin terbalik daripada kod anda.

Script dalam ServerScriptService bernama 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
		-- Tulis mengapa tiada apa-apa berlaku, jangan berdiam diri
		warn(`[CoinDrip] {player.Name} has no leaderstats.Coins yet`)
		return
	end

	-- Versi yang rosak:
	--   coins = coins + amount
	-- coins ialah objek IntValue, bukan nombornya, jadi Output menunjukkan:
	--   attempt to perform arithmetic (add) on Instance and number
	coins.Value += amount
end

-- Setiap minit, beri sedikit syiling kepada setiap pemain di pelayan
while true do
	task.wait(INTERVAL_SECONDS)
	for _, player in Players:GetPlayers() do
		addCoins(player, REWARD)
	end
end

attempt to concatenate string with nil

Operator .. hanya menyambung string dan nombor. Ia tidak boleh menyambung dengan nil, dan juga tidak dengan objek: "Hi " .. player memberi attempt to concatenate string with Instance. Gunakan player.Name, bungkus nilai dalam tostring(), atau gunakan interpolasi string dengan backtick, print(`Coins: {coins}`), yang akan mencetak nil dan tidak menghentikan skrip.

Expected 'end' dan ralat sintaks lain

Mesej yang bermula dengan Expected ialah ralat sintaks: kod itu bukan Luau yang sah, Roblox tidak boleh mengkompilnya, dan tiada satu baris pun dalam skrip itu berjalan, termasuk baris di atas ralat. Script Editor menggariskannya dengan warna merah semasa anda menaip, jadi ia boleh dibaiki sebelum menekan Play.

  • Expected 'end' (to close 'function' at line 3), got <eof>: function, if, for atau while yang bermula pada baris 3 tiada end miliknya. Nombor baris sebelum mesej selalunya menunjuk ke hujung fail, jadi lihat baris yang disebut dalam kurungan.
  • Expected 'then' when parsing if statement, got '=': satu = dalam syarat. Untuk perbandingan, anda perlukan ==.
  • Expected ')' (to close '(' at line 1), got 'local': kurungan tidak pernah ditutup.
  • Expected <eof>, got 'end': satu end berlebihan.

Dengan inden yang kemas, end yang tertinggal atau berlebihan mudah dikesan, kerana setiap blok berada pada aras yang sama dengan end yang menutupnya.

Requested module experienced an error while loading

require() pertama ModuleScript menjalankan kodnya. Jika modul itu gagal dengan ralat semasa berjalan, skrip yang memuatkannya menerima mesej ini. Masalah sebenar ialah ralat modul itu sendiri, satu atau dua baris di atas dalam Output: baiki yang itu. Dua mesej yang serupa:

  • Module code did not return exactly one value: modul tidak berakhir dengan return. ModuleScript mesti memulangkan satu nilai, bukan nil, biasanya jadualnya.
  • Requested module was required recursively: dua modul memuatkan satu sama lain. Pindahkan bahagian yang dikongsi ke modul ketiga yang dimuatkan oleh kedua-duanya.
ModuleScript dalam ReplicatedStorage bernama Format
local Format = {}

-- Menukar bilangan saat kepada minit dan saat: 95 menjadi "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

-- Modul mesti memulangkan jadualnya di hujung. Tanpa baris ini, setiap
-- require modul ini gagal dengan: Module code did not return exactly one value
return Format

Skrip memuatkannya melalui local Format = require(ReplicatedStorage:WaitForChild("Format")), kemudian memanggil Format.clock(95). Jika anda menulis Format.Clock(95), anda akan mendapat ralat attempt to call a nil value.

Argument 1 missing or nil

Fungsi Roblox menerima nil dalam argumen yang diperlukannya, dan nombor itu memberitahu argumen yang mana. workspace:FindFirstChild(itemName) gagal begini apabila itemName ialah nil. Pepijat jarang berada pada baris ini. Ia berada di tempat nilai itu sepatutnya datang: pemboleh ubah yang tersalah taip, atribut yang tidak pernah ditetapkan, atau argumen RemoteEvent yang tidak dihantar oleh client. Argumen RemoteEvent datang dari peranti pemain, jadi pelayan mesti menyemaknya sebelum digunakan. Caranya ditunjukkan dalam panduan RemoteEvent.

FireServer can only be called from the client

RemoteEvent mempunyai arah. LocalScript memanggil FireServer, dan Script pelayan mendengar melalui OnServerEvent. Script pelayan memanggil FireClient atau FireAllClients, dan LocalScript mendengar melalui OnClientEvent. Memanggil method dari sisi yang salah memberi ralat ini atau cerminannya, FireClient can only be called from the server. Biasanya pembaikannya ialah memindahkan kod ke jenis skrip yang betul: lihat Script, LocalScript dan ModuleScript.

Ralat data store 403 dalam Studio

Panggilan data store dalam Studio gagal dengan kod ralat 403 (StudioAccessToApisNotAllowed) sehingga anda membenarkannya. Terbitkan place, buka File, Experience Settings, Security, hidupkan Enable Studio Access to API Services dan simpan. Selepas itu Studio menggunakan data store yang sama seperti game sebenar, jadi Roblox menasihatkan anda melakukannya dalam salinan ujian yang berasingan, bukan dalam game yang sudah dimainkan orang. Bungkus setiap panggilan data store dalam pcall, kerana panggilan sebegini boleh gagal atas sebab di luar kod anda. Cara menyimpan dengan selamat diterangkan dalam tutorial DataStore.

Skrip berjalan tanpa ralat tetapi tidak berbuat apa-apa

Skrip yang senyap biasanya langsung tidak berjalan, masih menunggu sesuatu, atau berjalan di sisi yang salah. Sebelum menukar kod, jadikan print(script:GetFullName(), "started") baris pertamanya dan jalankan game. Jika baris itu tidak pernah muncul dalam Output, masalahnya ialah di mana skrip itu terletak atau bagaimana ia ditetapkan, bukan apa yang tertulis di dalamnya.

Mengapa skrip mungkin tidak berbuat apa-apa tanpa ralat
Apa yang perlu disemakApa yang salahCara membaikinya
Jenis dan lokasi skripLocalScript hanya berjalan jika diletakkan dalam StarterPlayerScripts, StarterCharacterScripts, StarterGui, StarterPack atau ReplicatedFirst (dari bekas Starter ia berjalan sebagai salinan pemain). Jika diletakkan dalam Workspace, ServerScriptService atau ReplicatedStorage, ia tidak akan pernah berjalan. Script dengan RunContext lalai hanya berjalan dalam Workspace atau ServerScriptService.Pindahkannya atau gunakan jenis skrip yang lain. Kod antara muka dan kawalan masuk ke LocalScript, peraturan game masuk ke Script dalam ServerScriptService.
EnabledSkrip yang kotak Enablednya tidak ditanda tidak berjalan.Pilih skrip itu dan tandakan Enabled dalam tetingkap Properties.
RunContextRunContext pada Script menentukan di mana ia berjalan. Legacy, nilai lalai, berjalan pada pelayan dari Workspace atau ServerScriptService. Server berjalan pada pelayan, Client berjalan pada peranti setiap pemain, contohnya dari ReplicatedStorage.Tetapkannya dengan sengaja. Dokumentasi Roblox menasihatkan meletakkan Client Script dalam ReplicatedStorage atau ReplicatedFirst, dan LocalScript dalam bekas Starter.
Event tidak berlakuTouched hanya berlaku daripada pergerakan fizik, sekurang-kurangnya satu daripada dua part mesti tidak diikat (anchored), dan kedua-duanya perlukan CanTouch. PlayerAdded tidak berlaku untuk pemain yang sudah berada di pelayan semasa anda menyambung ke event itu. Pengendali RemoteEvent tidak akan berjalan jika sisi lain tidak pernah memanggil event itu.Letakkan print di dalam pengendali untuk mengetahui dengan pasti sama ada ia berjalan, kemudian baiki apa yang sepatutnya memanggilnya.
Kod selepas gelung atau penantianBaris di bawah gelung while true do tidak pernah berjalan, kerana gelung itu tidak berakhir. Baris di bawah WaitForChild yang tidak pernah menemui objek juga tidak berjalan.Sambungkan event sebelum gelung atau jalankan gelung melalui task.spawn. Beri penantian had masa.
Semakan yang keluar secara senyapPengawal seperti if not coins then return end menghentikan fungsi secara senyap apabila objek tiada.Tambah warn dengan butiran sebelum return.
Penapis OutputOutput boleh ditapis mengikut jenis mesej, Client atau Server dan teks. Penapis yang terlupa boleh menyembunyikan ralat yang anda cari.Set semula penapis dan kosongkan kotak carian.
Hanya anda yang nampakPerubahan dibuat oleh LocalScript, jadi hanya pemain itu yang nampak. Pelayan dan pemain lain tidak nampak.Buat perubahan pada pelayan. Lihat di mana skrip berjalan.

Ramai yang terkena kes PlayerAdded, kerana dalam ujian Studio anda masuk hampir sejurus selepas pelayan bermula. Jika sesuatu di atas baris Connect menunggu, contohnya WaitForChild, task.wait atau require modul yang menunggu, anda mungkin masuk sebelum sambungan itu wujud. Uruskan kedua-dua pemain baharu dan pemain yang sudah masuk:

Script dalam ServerScriptService bernama Welcome
local Players = game:GetService("Players")

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

Players.PlayerAdded:Connect(onPlayerAdded)

-- Untuk pemain yang sudah berada di sini semasa baris di atas berjalan,
-- PlayerAdded dalam skrip ini tidak akan berlaku, jadi uruskan mereka sekarang
for _, player in Players:GetPlayers() do
	task.spawn(onPlayerAdded, player)
end

Alat debugging dalam Roblox Studio

print menulis baris ke Output, dan warn menulis amaran. Ini cara paling pantas untuk menjawab soalan "adakah ini berjalan langsung?" dan "apakah nilai ini?". print(x) kosong sukar dicari kemudian, jadi tambah label dan butiran penting. typeof(x) menunjukkan jenis nilai: nombor, string, Instance atau nil, dan GetFullName() menunjukkan objek mana yang anda ada.

Script dalam ServerScriptService bernama ShopDebug
local Players = game:GetService("Players")

local DEBUG = true -- tetapkan false apabila selesai
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 dan ClassName menunjukkan apa sebenarnya nilai itu
	debugPrint("Coins is", typeof(coins), if coins then coins.ClassName else "missing")
end)

Kotak carian dalam Output menapis mengikut teks, jadi label tetap seperti [ShopServer] membolehkan anda memaparkan baris sistem ini sahaja. Jika anda perlu tahu bagaimana kod sampai ke sesuatu baris, debug.traceback() memulangkan call stack semasa sebagai string.

Breakpoint dan pelaksanaan langkah demi langkah

Breakpoint menjeda game pada sesuatu baris supaya anda boleh melihat segala-galanya pada saat itu. Dalam Script Editor, klik ruang di sebelah kanan nombor baris (bulatan merah akan muncul), kemudian jalankan playtest. Apabila pelaksanaan sampai ke baris itu, game dijeda, dan anak panah kuning menunjukkan baris seterusnya. Butang pelaksanaan langkah demi langkah menggerakkan anda melalui kod:

  • Step Over (F10) melaksanakan baris semasa dan berhenti pada baris seterusnya.
  • Step Into (F11) masuk ke dalam fungsi yang dipanggil pada baris ini.
  • Step Out (Shift+F11) menjalankan fungsi semasa hingga selesai dan berhenti dalam kod yang memanggilnya.
  • Resume Scripts meneruskan hingga breakpoint seterusnya.

Klik kanan pada ruang itu memberi dua jenis lagi yang berguna. Breakpoint bersyarat hanya menjeda apabila ungkapan seperti amount < 0 benar. Logpoint mencetak mesej ke Output tanpa menjeda, jadi anda boleh merekod nilai tanpa menukar skrip.

Watch dan Call Stack

Semasa game dijeda, halakan kursor pada pemboleh ubah dalam Script Editor untuk melihat nilainya. Tetingkap Watch pada tab Variables menunjukkan semua pemboleh ubah dalam skop, dan pada tab My Watches anda boleh memasukkan sebarang ungkapan, contohnya coins.Value + amount, dan melihat nilai semasanya. Tetingkap Call Stack menunjukkan fungsi mana yang memanggil fungsi mana untuk sampai ke baris yang dijeda. Kedua-duanya dibuka melalui tab Script atau menu Window.

Script Analysis dan mod ketat

Script Editor menggariskan masalah semasa anda menaip, dan tetingkap Script Analysis, yang dibuka dengan butang Analysis pada tab Script, menunjukkan ralat dan amaran untuk semua skrip. Ia menangkap ralat sintaks dan nama yang tidak dikenali sebelum menekan Play. Jika baris pertama skrip ialah --!strict, semakan jenis ketat Luau dihidupkan, yang turut melaporkan salah taip dalam property, jenis argumen yang salah dan nilai yang mungkin nil. Tetapi ia tidak nampak game yang sedang berjalan: part yang tiada dalam Workspace hanya akan ditunjukkan oleh Output.

Command bar

Command bar (pada tab Script atau Ctrl+9, ⌘9 pada Mac) menjalankan Luau serta-merta. Semasa game berjalan, ia cara pantas untuk bertanya: print(workspace:FindFirstChild("Bridge")) memberitahu sama ada part itu wujud, dan print(#game:GetService("Players"):GetPlayers()) mengira pemain. Dalam mod edit, kod daripada command bar benar-benar mengubah place anda, jadi berhati-hati dengan apa sahaja yang menggerakkan atau memadam objek.

Developer Console dalam game sebenar

Output dalam Studio hanya berfungsi dalam Studio. Dalam game sebenar, tekan F9 atau tulis /console dalam chat untuk membuka Developer Console. Log-nya menunjukkan output daripada peranti anda, dan output pelayan jika anda pemilik game atau ahli kumpulan yang mempunyai hak untuk menyuntingnya.

Assistant terbina dalam Roblox juga boleh membantu dengan mesej tertentu: panduan Roblox sendiri menasihatkan anda menampal ralat daripada Output dan meminta Assistant menerangkannya. Jika Assistant berhenti menjawab atau menulis bahawa anda telah mencapai had, lihat had dan ralat Assistant.

Membaiki ralat dengan RoCode

RoCode ialah ejen AI bebas untuk Roblox Studio: anda terangkan masalah dalam chat web, dan plugin Studio membaca dan menyunting place yang sedang anda buka. Untuk ralat, ia boleh mengambil alih langkah membaca daripada urutan di atas, berdasarkan playtest yang sudah anda jalankan.

Anda tulis

Saya tekan Play, dan klik pada butang kedai tidak berbuat apa-apa. Output menunjukkan attempt to index nil with 'Coins'. Cari puncanya dan baiki.

RoCode buat
  • Membaca Output dalam Studio dengan alat Check Output, termasuk baris Server dan Client daripada playtest terakhir anda, walaupun selepas anda menekan Stop
  • Membuka skrip daripada ralat melalui Read Script dan membaca kod di sekitar baris itu, dan melalui Search Scripts boleh mencari di mana nilai yang hilang sepatutnya dicipta
  • Membuat suntingan tepat melalui Edit Script, cari dan ganti yang tepat dalam skrip itu, kemudian menjalankan Check Script, yang mengkompil skrip di dalam Studio (ia tidak menyemak jenis, tidak menjalankan linter dan tidak melaksanakan kod anda)
  • Menghantar perubahan ke Studio secara berkumpulan, dan setiap kumpulan ialah titik undo dalam sejarah Studio

Tekan Play sekali lagi dan klik butang kedai untuk memastikan sendiri pembaikan itu: dengan plugin 3.9 atau lebih baharu, RoCode boleh menjalankan playtest pendek dan membaca ralat, dan dengan plugin 3.9.15 atau lebih baharu watak ujiannya boleh menekan butang pada skrin, tetapi ia hanya menyemak apa yang dipilihnya sendiri untuk diuji, dan semakan kompilasi tidak memberitahu sama ada logik game itu betul. Membaca ralat termasuk dalam setiap binaan: kitaran bina, semak dan uji untuk seluruh game mengulang semakan ini selepas setiap sistem. Cara RoCode bersambung ke Studio.

Soalan lazim

Mengapa skrip Roblox tidak berfungsi walaupun tiada ralat?

Biasanya skrip itu langsung tidak berjalan (jenis skrip atau bekas yang salah, atau Enabled dimatikan), ia masih menunggu sesuatu, atau event yang didengarnya tidak pernah berlaku. Print pada baris pertama akan menunjukkan yang mana satu. Lihat senarai semak di atas.

Apakah maksud "attempt to index nil" dalam Roblox?

Nilai sebelum titik atau titik bertindih ialah nil, jadi Roblox tidak dapat melihat ke dalamnya. Pada baris player.Character.Humanoid, ralat attempt to index nil with 'Humanoid' bermaksud player.Character ialah nil: ia tiada atau belum dimuatkan. Semak nilai dengan if sebelum menggunakannya, dan dalam LocalScript tunggu objek yang dicipta oleh pelayan dengan WaitForChild. Lebih lanjut tentang puncanya.

Apakah maksud "infinite yield possible" dalam Roblox?

WaitForChild sudah menunggu lebih daripada 5 saat untuk objek anak yang tidak pernah muncul, dan terus menunggu. Selalunya nama atau parent salah, atau tiada siapa mencipta objek itu. Lebih lanjut tentang puncanya.

Mengapa tetingkap Output kosong atau tidak muncul?

Bukanya melalui menu Window atau tab Script. Jika ia terbuka tetapi kekal kosong semasa ujian, set semula penapis dan kotak carian, kemudian semak bahawa skrip yang sepatutnya mencetak sesuatu memang berjalan.

Adakah Roblox ada penyemak ralat skrip?

Ya, ia terbina dalam Studio: Script Editor menggariskan masalah semasa anda menaip, dan tetingkap Script Analysis memaparkannya dalam senarai. Ia menemui ralat sintaks dan ralat jenis, tetapi bukan objek yang tiada atau logik game yang salah: itu hanya kelihatan apabila kod berjalan.

Perlukah saya bungkus kod dalam pcall supaya tiada ralat?

Hanya panggilan yang boleh gagal atas sebab di luar kod anda, contohnya permintaan data store, HTTP atau MarketplaceService. Jika anda bungkus ralat nil dalam pcall, mesej itu hilang, tetapi fungsi itu tetap tidak berfungsi.

Bagaimana cara melihat ralat skrip dalam game sebenar?

Tekan F9 dalam game atau tulis /console dalam chat untuk membuka Developer Console. Ia menunjukkan ralat daripada peranti anda, dan daripada pelayan jika anda pemilik game atau ahli kumpulan yang boleh menyuntingnya.

Sumber dan bacaan lanjut

Cara kod disemak: setiap skrip di halaman ini lulus semakan jenis Luau yang ketat dengan definisi API Roblox (luau-lsp, 20 November 2026). Semakan jenis mengesan kesilapan nama API dan jenis yang salah, tetapi bukan kesilapan logik permainan, jadi uji semuanya dalam Studio sebelum anda menerbitkannya.

Cuba RoCode dalam permainan anda.

Kredit percuma setiap hari, tanpa kad. Pasang plugin, terangkan ciri yang anda mahu dan semak hasilnya dalam Studio.