Pascal Editor 开发环境搭建教程端口、环境变量与 Prerequisites 完整清单【免费下载链接】editorCreate and share 3D architectural projects.项目地址: https://gitcode.com/GitHub_Trending/editor93/editorPascal Editor 是一款基于 React Three Fiber 和 WebGPU 的开源 3D 建筑编辑器。本文是一份面向新手的环境搭建指南完整覆盖 Prerequisites 前置条件、开发端口3002/3000、环境变量配置与 Docker 启动方式帮助你在 10 分钟内跑起自己的 3D 建筑编辑环境。✅ 一、Prerequisites搭建前必备条件清单Pascal Editor 是一个 Turborepo 单体仓库monorepo使用Bun作为包管理器。在动手之前请对照下面这张清单检查你的环境前置条件版本要求说明Bun1.3包管理器与运行时根目录package.json中锁定为bun1.3.14Node.js20.9engines字段声明的最低版本Git任意稳定版用于拉取仓库Docker可选任意稳定版仅在使用容器方式启动时需要 官方文档在仓库根目录的SETUP.md中Prerequisites 一节只列了 Bun 1.3 和 Node.js 20.9 两项其余依赖都会由bun install自动处理。 二、一键安装从克隆到启动只需 3 步步骤 1克隆仓库git clone https://gitcode.com/GitHub_Trending/editor93/editor cd editor步骤 2安装依赖bun install步骤 3启动开发服务器bun dev启动后浏览器访问http://localhost:3002即可看到编辑器。bun dev实际执行的是根package.json中的脚本先通过dotenv加载.env和.env.defaults再由 Turborepo 启动所有包的构建监听和 Next.js 开发服务器——所以请务必在仓库根目录执行这样才能获得packages/core、packages/viewer等包的热更新。️ 三、端口说明3002 和 3000 各代表什么新手最容易困惑的就是端口问题这里一次性讲清楚3002—— 本地开发默认端口。由仓库根目录的.env.defaults文件统一写入PORT3002该文件会被bun dev自动加载优先级低于 shell 环境变量和.env.local。3000—— Docker 容器端口。docker-compose.yml中固定映射3000:3000且不建议修改/scenes页面通过NEXT_PUBLIC_APP_URL拉取自身 API该值在 Next.js 构建时内联端口映射不一致会导致页面返回 500。动态端口—— 使用官方 CLI 启动时会自主选择无冲突的回环端口见下文。另外仓库自带.devcontainer/devcontainer.jsonVS Code Dev Containers 用户打开仓库后会自动基于 Bun 镜像启动容器并转发 3002 端口省去了手动安装运行时。⚙️ 四、环境变量完整清单多数可跳过本地开发和官方托管版本无需任何环境变量即可运行。如果你需要自定义可执行cp .env.example .env以下是完整的环境变量参考清单变量名是否必填默认值作用PORT否3002开发服务器端口定义在.env.defaultsMINT_PASCAL_HOST_ORIGIN否—自托管部署时的公共编辑器地址用于登录与同源校验NEXT_PUBLIC_APP_URL否—应用基地址Docker 场景下决定/scenes的 API 基址PASCAL_DATA_DIR否—Docker 中场景数据库SQLite存放目录compose 文件里指向/dataNEXT_PUBLIC_ASSETS_CDN_URL否—素材 CDN 地址可选客户端侧变量PASCAL_PORTABLE_BUILD否—置为1时生成standalone便携构建Google Maps API Key否—启用地址搜索功能缺失不影响其他功能客户端侧变量的校验逻辑见apps/editor/env.mjs基于 Zod 的createEnv.env.example中对每个变量都附有用途注释建议先读注释再填写。 五、Docker 方式不装 Bun 也能跑如果不想在本地安装 Node/Bun一条命令即可docker compose up -d启动后访问http://localhost:3000。关键细节保存的场景存放在pascal-data数据卷中docker compose down也不会丢失数据若在其他域名托管可覆盖来源变量MINT_PASCAL_HOST_ORIGINhttps://pascal.example.com docker compose up -d镜像基于oven/bun:1.3.14-alpine见Dockerfile并额外安装了 Node.js因为 Next 16 的构建在纯 Bun 镜像中会崩溃——这也是版本对齐--frozen-lockfile的常见坑点。 六、常用脚本速查表命令作用bun dev启动开发服务器http://localhost:3002bun build构建所有包bun checkBiome 检查 lint 与格式bun check:fix自动修复 lint 与格式问题bun check-typesTypeScript 类型检查bun run test通过 Turborepo 运行全部包测试bun kill一键结束占用 3002 端口的进程bun restart结束进程 清理缓存 重新bun dev⚠️ 注意跑测试请用bun run test而不是裸bun test——后者会绕过 Turborepo 直接扫描dist/下的编译产物导致统计虚高。❓ 七、常见问题端口被占用了怎么办这是新手最高频的报错场景。3002 端口被占用时执行bun kill它等价于lsof -ti:3002 | xargs kill -9定义在根package.json。如果依赖状态异常例如切换分支后报错用bun restart一次性完成杀进程、清理.next/.turbo缓存并重启。 搭建完成你将获得什么开发环境跑通后你打开的就是一个功能完整的 3D 建筑编辑器墙体、楼板、门窗、屋面等建筑元素以节点树Site → Building → Level → Wall/Slab/Roof组织内置数百种家具与建筑构件空调、窗户、灯具等 3D 模型和 PBR 材质纹理均位于apps/editor/public/下并支持撤销重做、空间网格碰撞校验与 WebGPU 渲染。 小结目标一句话方案本地开发装好 Bun 1.3 与 Node 20.9然后bun installbun dev访问 3002 端口自定义配置复制.env.example为.env按需填PORT、MINT_PASCAL_HOST_ORIGIN免安装运行docker compose up -d访问 3000 端口掌握以上端口、环境变量与前置条件三张清单你就完成了 Pascal Editor 开发环境的全部搭建可以开始你的 3D 建筑项目之旅了。【免费下载链接】editorCreate and share 3D architectural projects.项目地址: https://gitcode.com/GitHub_Trending/editor93/editor创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考