NocoBase 本地開發(fā)環(huán)境如何從零跑通5 步克隆、編譯、啟動并驗證接口【免費下載鏈接】nocobaseNocoBase is an open-source AI no-code platform for building business systems fast. Instead of generating everything from scratch, AI works on top of production-proven infrastructure and a WYSIWYG no-code interface, so you get both speed and reliability.項目地址: https://gitcode.com/GitHub_Trending/no/nocobase剛把 NocoBase 的倉庫拉下來怎么最快讓它在你自己電腦上轉(zhuǎn)起來這篇文章帶你走一遍最短路徑裝依賴、起開發(fā)服務(wù)、再改一個最小示例應(yīng)用加上數(shù)據(jù)庫最后用一個 curl 請求證明它真的在運行。全程不需要先裝數(shù)據(jù)庫跑完你會看到一條來自本地服務(wù)的真實響應(yīng)。先確認兩個版本Node 和 Yarn這一步別跳過版本不對后面全是坑。依據(jù)倉庫里的兩份配置package.json 中engines: { node: 18 }并且用 volta 字段把版本釘死在node 20.16.0、yarn 1.22.19Dockerfile 官方鏡像用的是node:22-bookworm所以給你一條穩(wěn)妥的結(jié)論Node 用 20 LTS或 22包管理器用 Yarn 1.x。不要上 pnpm 或 npm 裝這個倉庫它是 yarn workspaces 結(jié)構(gòu)packages/*/*多級工作區(qū)。node -v # 應(yīng)輸出 v20.x 或 v22.x低于 18 請換版本 yarn -v # 應(yīng)輸出 1.22.x沒有就 npm install -g yarn3 條命令克隆并裝好依賴# 克隆倉庫倉庫地址就是這一個 git clone https://gitcode.com/GitHub_Trending/no/nocobase cd nocobase # 裝依賴倉庫共幾十個 workspace 子包耐心等待 yarn install? 成功標志yarn install最后打印Done in ...。兩個常見卡點先說清楚??yarn install會觸發(fā)根目錄的postinstall腳本nocobase-v1 postinstall裝到一半卡住其實是它在跑不是死機。如果你看到某個原生模塊node-gyp 相關(guān)編譯失敗基本是 Node 版本過新或過老先回到上一節(jié)對齊版本再刪掉node_modules重裝。一條命令起開發(fā)服務(wù)用 curl 驗證真的啟動了裝完依賴直接進開發(fā)模式# 啟動帶熱更新的開發(fā)服務(wù)前端用 rsbuild 構(gòu)建 yarn dev跑完等幾十秒終端里出現(xiàn)服務(wù)監(jiān)聽地址默認 13000 端口就是起來了。然后開另一個終端# 請求一條接口驗證服務(wù)真的能響應(yīng) curl http://localhost:13000/api/app:info? 成功標志返回一段 JSON。如果返回 JSON 里帶401之類的鑒權(quán)信息也算成功——說明服務(wù)和接口框架都在工作只是這個接口要求登錄。真正失敗的表現(xiàn)是Connection refused那說明進程根本沒監(jiān)聽端口回到終端看報錯。想要只熱更后端、不動前端就換yarn dev-server想打生產(chǎn)構(gòu)建產(chǎn)物用yarn build然后yarn start以生產(chǎn)模式跑。換個最小示例應(yīng)用把數(shù)據(jù)庫也帶上內(nèi)置首頁已經(jīng)能看了但開發(fā)者的日常是寫自己的代碼。倉庫里放了一個最小可運行應(yīng)用就是為這個場景準備的# 啟動 examples 目錄下的單應(yīng)用示例 yarn run:example app/single-app start# 訪問示例自帶的 test 資源 curl http://localhost:13000/api/test:list? 成功標志響應(yīng)體是字符串test list?？吹剿f明你的代碼 → 服務(wù) → 接口這條鏈路完整通了。數(shù)據(jù)庫怎么接示例從環(huán)境變量讀配置完整寫法見 examples/app/single-app.ts核心字段是這幾個database: { dialect: process.env.DB_DIALECT, // 方言sqlite / mysql / postgres storage: process.env.DB_STORAGE, // sqlite 時填 .db 文件路徑 // 其余 username / password / host / port 按方言按需設(shè)置 }本地想最快跑通選 SQLite 就對了——不用起任何數(shù)據(jù)庫進程# 用環(huán)境變量告訴示例用哪個庫然后重新啟動 DB_DIALECTsqlite DB_STORAGE./storage/dev.db yarn run:example app/single-app start需要真正操作表結(jié)構(gòu)時倉庫提供了遷移示例# 跑 examples 里的建表/刪表演示遷移 yarn run:example app/migrations/add-migration migrator up卡住了按這份清單自查Qyarn install一直報網(wǎng)絡(luò)錯誤或超時這個倉庫依賴量很大幾百個子包。先換國內(nèi)鏡像源再試yarn config set registry https://registry.npmmirror.com。倉庫根目錄還有個cnpm-sync.js輔助腳本裝不上時可以在文檔里查它的用法。Q改了代碼沒生效配置不生效先確認你啟動的方式。yarn dev是熱更新模式改后端 TS 文件保存即重編如果你用的是yarn start生產(chǎn)模式改任何源碼都不會生效必須yarn build重新打包。Q端口 13000 被占用curl報ECONNREFUSED多半是上次進程沒退干凈。先CtrlC停掉舊進程或換一個端口啟動時通過環(huán)境變量調(diào)整examples/app/single-app.ts里沒寫死端口以終端實際輸出為準。Q我想寫自己的插件代碼放哪新插件統(tǒng)一放在packages/plugins/nocobase/plugin-你的插件名/目錄下直接復(fù)制現(xiàn)有插件的目錄結(jié)構(gòu)改造即可倉庫的 AGENTS.md 明確寫了復(fù)用現(xiàn)有腳手架不要自創(chuàng)新布局。倉庫中未找到一鍵生成插件的獨立腳本命令可參考官方文檔的插件開發(fā)章節(jié)。Q前端頁面白屏看瀏覽器控制臺的網(wǎng)絡(luò)請求接口 404 通常是服務(wù)沒起完yarn dev首次編譯前端需要更久接口 401 則是正常鑒權(quán)攔截用登錄接口或數(shù)據(jù)庫里現(xiàn)成的管理員賬號登錄即可。跑通之后你可以順著本地界面進入數(shù)據(jù)建模效果類似官方文檔里的這個界面表間關(guān)系配置關(guān)鍵步驟速查表步驟命令克隆倉庫git clone https://gitcode.com/GitHub_Trending/no/nocobase cd nocobase裝依賴Node 20 Yarn 1.xyarn install起開發(fā)服務(wù)并熱更新yarn dev驗證服務(wù)可用curl http://localhost:13000/api/app:info跑最小示例 驗證接口yarn run:example app/single-app start后curl http://localhost:13000/api/test:list【免費下載鏈接】nocobaseNocoBase is an open-source AI no-code platform for building business systems fast. Instead of generating everything from scratch, AI works on top of production-proven infrastructure and a WYSIWYG no-code interface, so you get both speed and reliability.項目地址: https://gitcode.com/GitHub_Trending/no/nocobase創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考