本资料介绍在 Roblox 上测试、调试与分析体验（Experience）的实践与工具，强调从可复现的失败入手，先判断问题出在客户端、服务器还是两端，再据此选择调试或性能分析工具。
调试思路方面，资料给出若干原则：先复现问题；通过逐个移除系统来隔离原因；用工具测量而非猜测；一次只修复一个问题并验证，条件允许时补充回归测试；并做好防御性日志。日志使用上，区分 print（常规诊断）、warn（可恢复但需注意的问题）和 error（应终止执行的编程错误），要求在消息中附带上下文，并避免记录密钥、玩家数据或 PII，示例为 warn(string.format("[DataStore] Save failed for %d: %s", userId, tostring(err)))。
错误处理方面，对易失败调用（尤其是云服务、HTTP、DataStore、Marketplace）使用 pcall 包裹，对内部不应失败的不变量使用 assert。捕获完整堆栈时可使用 xpcall 配合 debug.traceback，特别适用于顶层入口、计划回调和连接处理器。
调试工具部分，Developer Console 可用 F9 在游戏内或 Studio 播放模式打开，包含 Log、Memory、Network、Server Stats、Script Profiler、MicroProfiler 等标签，并可切换 Client/Server 视图查看输出来源。Studio 内置调试器支持断点、单步（跳过/进入/跳出）以及调用栈、局部变量和上值检查，客户端与服务器上下文均可使用。
测试方面，Roblox 标准测试框架是 TestEZ，支持嵌套 describe/it 块、生命周期钩子、异步测试和丰富的匹配器 API，示例展示了 MathUtils.clamp 的断言与 TestEZ.TestBootstrap:run 的调用方式。旧式 Studio 内测试可用 TestService:Error(msg) 标记失败，但多数项目应优先使用 TestEZ；scripts 目录中的 TestRunner.lua 仅在 TestEZ 不可用时作为最小替代。此外推荐使用 luau-lsp 或 Studio 的 Luau 类型检查器在运行前发现错误，包括为模块导出和纯函数添加类型标注、在 CI 或提交前运行 luau-lsp analyze、对新模块启用 --!strict、避免过度标注无类型引擎 API 而在边界处使用强制转换。
资源管理方面，泄漏的 RBXScriptConnection 是内存泄漏和状态残留的常见来源，建议使用 Maid/Janitor 风格收集器统一管理连接，一次性处理器使用 :Once()，用 Instance.Destroying 触发清理，并始终让 :Connect() 与 :Disconnect() 或销毁配对。调度建议优先使用 task 库（task.wait、task.delay、task.spawn、task.defer），避免 spawn/delay/wait。日志需做速率限制并对敏感值脱敏。
网络与数据方面，网络所有权分配不当会导致物理抖动和复制延迟，可在服务器端用 part:SetNetworkOwner(player) 显式指定，用 BasePart:GetNetworkOwner() 检查，载具和手持物品通常应由控制玩家拥有。DataStore 读取可使用带指数退避和抖动的有界重试，但该通用循环不应用于重放写入，因为失败响应可能掩盖已提交的写入，独立重试还可能乱序执行，写入对账与按键排序需参见 roblox-datastores；DataStore 必须从服务器调用并在保存前验证序列化。
性能与内存分析方面，内存快照对比流程为：在稳定状态采集基线，执行可能泄漏的操作（生成/销毁敌人、打开/关闭 UI），回到稳定状态再采集一次，比较 PlaceMemory、Luau 堆和实例数量，对未回到基线的类别展开调查，并在 Scene Analysis 中查找未挂载（unparented）实例。MicroProfiler 可用 Ctrl+F6（⌘+F6）在 Studio 或桌面客户端打开，用于查找帧时间尖峰、判断瓶颈属于脚本计算/物理/渲染、从 Developer Console 捕获服务器转储，并可用 debug.profilebegin/debug.profileend 添加自定义标签；关键颜色中橙色代表工作线程瓶颈，蓝色代表渲染线程瓶颈，红色代表 GPU 等待或渲染复杂度。Scene Analysis 位于 Studio 的 Window → Performance Summary → Scene Analysis，提供脚本内存、未挂载实例、实例构成、音频/动画内存、三角形构成等视图，它是 Studio UI 工具，没有公开的 SceneAnalysisService API。Script Profiler 按脚本记录 CPU 时间，适合在 MicroProfiler 指出脚本问题后进一步定位具体脚本。
资料还列出常见 Bug 分类表，将“脚本静默失败”“数据未保存”“Remote 不工作”“卡顿尖峰”“物理抖动”“NPC 卡住”“UI 不更新”“内存持续增长”等症状对应到可能的成因。网络调试方面，可在 Developer Console 的 Network 标签检查 HTTP/DataStore 失败，游戏内用 Shift+F3 查看网络调试统计，区分网络 ping（往返时间）与数据 ping（复制队列）；Studio 测试版网络模拟器可分别设置进出延迟、抖动和丢包，需在 Beta Features 启用 New Device Simulator、重启 Studio，再打开 Test → Device Simulator → Network 并选择 Apply 才会生效；Ideal Fiber 每个方向仍会增加 8 毫秒，使用全零自定义值可获得零附加延迟基线。加载时间调试可使用 os.clock() 与 game.Loaded 事件测量，并在 Studio Settings → Network 中启用 Print Join Size Breakdown 查看最大的复制实例。
scripts 目录包含三个脚本：TestRunner.lua（带嵌套套件、生命周期钩子、匹配器、异步支持与 TestService 集成的最小 TestEZ 替代）、Logger.lua（带级别过滤与受保护格式化的结构化日志器）、DebugDraw.lua（在 3D 中绘制射线、点和盒子的可视化调试工具）。参考索引文档包括 common-bugs-and-fixes.md、debugging-tools.md、network-simulation.md、performance-profiling.md、testing-patterns.md。整体推进流程建议为：可靠复现问题、检查 Developer Console 日志与错误、判断客户端还是服务器范围、对性能问题使用 MicroProfiler/Script Profiler、对内存泄漏和场景构成使用 Scene Analysis、添加针对性日志或测试确认修复、在低端设备和网络模拟下验证、对比疑似泄漏前后的内存快照。