用途:为 Roblox 项目搭建专业工具链,覆盖代码同步、依赖管理、类型检查、格式化、Lint、构建与 CI。
同步模式:仅需外部编辑器改代码、Studio 为唯一真源时用内置 Studio Script Sync(右键文件夹 → Sync to…),它只同步 Script/LocalScript/ModuleScript/Folder,每个同步根上限 10000 个脚本、最多 128 个根,带属性/标签的脚本不会写入磁盘。需要整个项目以文件系统为真源、支持 CI 构建与包管理时用 Rojo(rojo serve + Studio 插件)。两者都可搭配 VS Code 的 Luau Language Server 扩展及其 Companion Studio 插件,以获取 DataModel 树做 require 与实例路径类型检查。
工具链固定:用 Rokit 的 rokit.toml 固定版本并提交,运行 rokit install。安装命令:curl -sSf https://raw.githubusercontent.com/rojo-rbx/rokit/main/scripts/install.sh | bash(Windows 用 install.ps1),用 rokit add owner/repo 添加工具。Aftman 与 Foreman 是更早的同类工具。
Rojo:default.project.json 定义 DataModel 树与路径映射。文件映射规则:Foo.luau → ModuleScript,Foo.server.luau → Script,Foo.client.luau → LocalScript,含 init.luau 的文件夹 → 该脚本加子项,.meta.json → 属性/特性,.model.json/.rbxm/.rbxmx → 实例,.json/.toml/*.txt → 返回数据的 ModuleScript 或 StringValue。常用命令:rojo serve、rojo build -o game.rbxl、rojo sourcemap default.project.json -o sourcemap.json、rojo upload / Open Cloud 发布。地图与美术可留在 Studio 或 .rbxm,代码交给 Rojo,允许部分托管。
包管理:Wally 用 wally.toml,wally install 输出到 Packages/,realm = "server" 的依赖进 ServerPackages/;Wally thunk 会丢类型,安装后运行 wally-package-types --sourcemap sourcemap.json Packages/。pesde(pesde.toml)是较新的管理器,支持 Roblox/Lune/Luau,也可依赖 Wally 包。提交 wally.lock/pesde.lock,不提交 Packages/。
代码质量:luau-lsp 做类型检查,CLI 示例:luau-lsp analyze --definitions=@roblox=globalTypes.d.luau --sourcemap=sourcemap.json --base-luaurc=.luaurc src/;编辑器可开启 luau-lsp.fflags.enableNewSolver 以对齐 Studio。StyLua 格式化,stylua --check src。selene 做 Lint,std = "roblox",用 selene generate-roblox-std 刷新。darklua 做代码转换(如转换字符串 require、打包)。.luaurc 可设 languageMode 与 aliases。
Lune:Roblox 之外的独立 Luau 运行时,用于构建步骤、读写 .rbxl/.rbxm、资源管线、纯 Luau 单元测试、通过 @lune/net 调用 Open Cloud,如 lune run scripts/build。
roblox-ts:仓库含 tsconfig.json 与 roblox-ts、@rbxts/types 时用 TypeScript,npx rbxtsc -w 把 src/.ts 编译到 out/.luau,再由 Rojo 同步 out/,不要手改生成的 Luau。
Git 与 CI:.gitignore 应含 .rbxl.lock、.rbxlx.lock、Packages/、ServerPackages/、sourcemap.json 与构建产物;CI 工作流见 references/ci-workflow.md。相关技能:roblox-testing、roblox-open-cloud、roblox-studio-mcp、roblox-luau。
限制:资料未提供各工具的具体收费、平台支持范围与效果保证;版本号以资料所述为准,升级需谨慎。