返回开源软件模块
wasp
AI 开源软件项目库

wasp

wasp-lang/wasp

wasp(wasp-lang/wasp)是一款面向SaaS Web 应用快速搭建的开源项目。Wasp 是一个面向 AI 时代的全栈 Web 开发框架(Web Application Specification)。它通过声明式 `.wasp` 文件定义应用高层结构,并结合 React、Node.js、Prisma 代码,由编译器生成前端、后端与部署相关工程。项目强调“少样板、可控源码、无平台锁定”,内置认证、RPC、后台任务、邮件发送与端到端类型安全。适合希望快速交付并保持全栈一致性的 Web 应用团队。

haskell
javascript
node
open-source
prisma
react
wasp
web-app
GitHub Stars
18.2k
Forks
1.4k
最近活跃
1 天内
部署方式
3
部署复杂度

项目简介

Wasp 是一个面向 AI 时代的全栈 Web 开发框架(Web Application Specification)。它通过声明式 `.wasp` 文件定义应用高层结构,并结合 React、Node.js、Prisma 代码,由编译器生成前端、后端与部署相关工程。项目强调“少样板、可控源码、无平台锁定”,内置认证、RPC、后台任务、邮件发送与端到端类型安全。适合希望快速交付并保持全栈一致性的 Web 应用团队。

适合谁优先上手

想围绕“SaaS Web 应用快速搭建”寻找可私有化部署方案的个人或团队
偏好 TypeScript 技术生态、希望后续可以自行扩展的人
愿意投入一定运维成本,换取更高可控性的团队

安装方式

安装方式以 CLI 为主:在 OSX / Linux / WSL(Windows) 环境执行 `npm i -g @wasp.sh/wasp-cli@latest`。安装后按官方 Quick Start 引导即可在较短时间内启动首个应用。部署前建议先准备好 Node/npm 开发环境,并明确数据库建模将使用 Prisma schema。若要体验 AI 生成项目,可在 `wasp new` 中选择 `ai-generated`,并按说明提供 OpenAI Key;或改用 Mage Web 应用。

使用说明

上手时先用 `.wasp` 文件定义应用骨架(如 app、route、page、query、auth),再在 `@src` 中补充 React 组件与 Node.js 逻辑,同时在 `schema.prisma` 定义数据模型。建议先验证一个最小闭环:受保护页面 + 查询操作 + 数据实体,确认认证、前后端通信与类型链路正常。随后再逐步接入后台任务、邮件能力等高级特性。已有 JS/TS 全栈项目也可按模块迁移到 Wasp 的声明式组织方式。

部署与运营建议

部署前先看

部署 wasp 时,建议先跑最小可用版本,再补域名、权限、备份、监控这些正式环境必需项。

  • 推荐优先评估 Wasp CLI 单命令部署、自托管部署(任意云平台/服务器) 这类成熟部署路径。
  • 如果依赖数据库、缓存、中间件较多,先固定版本号和数据目录,再做联调。
  • 不要跳过回滚方案设计;上线失败后能不能快速回退,比一次装成功更重要。

长期维护怎么看

真正决定 wasp 值不值得长期保留的,不是首日安装成功,而是后续运维和团队接手成本。

  • 建议在内部记录登录入口、关键配置、升级步骤和排障入口,避免工具变成“只有部署者自己懂”的孤岛。
  • 优先把它接进 SaaS Web 应用快速搭建、带完整认证的全栈后台系统 这类高频场景,才能更快验证 ROI。
  • 每隔一段时间复盘:它到底替代了什么、节省了什么、后续是否还值得继续维护。

优势与注意事项

这个项目的加分点

  • 已有提炼后的项目摘要,能更快判断是否值得试跑
  • 支持 Wasp CLI 单命令部署、自托管部署(任意云平台/服务器)、无厂商锁定的自选部署方案 等部署方式,落地路径相对明确
  • 适用场景已经比较明确,可直接对照 SaaS Web 应用快速搭建、带完整认证的全栈后台系统 等业务需求评估
  • 标签覆盖 haskell、javascript、node,利于后续做站内专题聚合

上正式环境前要注意

  • 部署链路和依赖项可能偏多,正式上线前应先做回滚演练

中国用户部署时重点关注

如果官方更偏手工安装,中国用户要先确认依赖下载源是否稳定,避免卡在安装阶段。
除 GitHub 仓库外,建议同时检查官网文档站在国内网络下的访问速度与可读性。
凡是涉及邮件、对象存储、OAuth、Webhook 的能力,都建议在正式部署前先做一轮国内环境联调。

常见问题 FAQ

wasp 是什么?

wasp(wasp-lang/wasp)是一款面向SaaS Web 应用快速搭建的开源项目。Wasp 是一个面向 AI 时代的全栈 Web 开发框架(Web Application Specification)。它通过声明式 `.wasp` 文件定义应用高层结构,并结合 React、Node.js、Prisma 代码,由编译器生成前端、后端与部署相关工程。项目强调“少样板、可控源码、无平台锁定”,内置认证、RPC、后台任务、邮件发送与端到端类型安全。适合希望快速交付并保持全栈一致性的 Web 应用团队。

wasp 适合谁?

如果你正在寻找围绕“SaaS Web 应用快速搭建”的开源方案,并希望保留私有化部署或自主可控能力,wasp 值得优先试跑。

wasp 怎么部署更稳?

建议优先按照 Wasp CLI 单命令部署、自托管部署(任意云平台/服务器)、无厂商锁定的自选部署方案 这类官方或社区成熟方案做最小可用部署,先验证核心流程,再决定是否做正式上线。

wasp 在中国用户环境下要注意什么?

重点检查镜像拉取、依赖下载、文档访问速度,以及邮件、Webhook、对象存储等外部依赖是否能顺利联调。

wasp 的部署复杂度高吗?

wasp 目前可归为“高”复杂度:建议根据依赖项数量、部署方式和后续运维能力来决定是否进入正式环境。