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），僅供參考 Pascal Editor 開發環境搭建教程：端口、環境變量與 Prerequisites 完整清單
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），僅供參考