常用命令

先确认终端所在目录。核心工作区、独立业务应用与文档仓库的命令作用范围不同。

核心仓库根目录

命令	用途
docker compose up -d	启动本地 PostgreSQL 与 Redis
pnpm install --frozen-lockfile	按唯一工作区锁文件安装
pnpm --filter @modu/web build	构建前端核心库
pnpm dev	运行 starter 前端
pnpm build	依次构建核心库与 starter

应用 server 目录

命令	用途
go run .	运行应用
go run . artisan migrate	执行前向迁移
go run . artisan db:seed	首次开发初始化种子
go run ./cmd/modu new-extension sample	创建应用扩展骨架
go run ./cmd/modu catalog generate	生成前端 catalog
go run ./cmd/modu catalog check	检查 catalog 与装配一致
go run ./cmd/modu doctor	静态装配诊断
go run ./cmd/modu check	检查源码、安装集合与配套版本
go build ./... / go vet ./...	编译与静态检查
go test ./...	在已配置的测试环境中执行测试

应用 web 目录

命令	用途
pnpm dev	前端开发服务
pnpm lint / pnpm typecheck	风格与类型检查
pnpm test	应用测试
pnpm build	生产构建
pnpm extension:check	检查扩展声明、binding 与导入边界
pnpm extension:verify-build	构建后检查真实 chunk 与预算

文档仓库根目录

命令	用途
pnpm dev --background	启动后台文档开发服务
pnpm exec astro dev stop	停止后台服务
pnpm verify	类型检查、静态构建、链接与搜索测试
pnpm preview	预览 dist，包含完整搜索索引

Pagefind 索引在构建时生成，开发服务不能替代完整搜索验收。