medusajs/medusa，32.4k，最新版本已经到v2.13.4。

很多人叫它“开源界的Shopify替代品”。不是那种装完就能用的拖拽商城，而是一套Node.js + TypeScript的框架，需要自己搭一套完全可控的电商后端。

从开发思路、架构、代码结构、适用场景、AI进展，到真实优缺点，聊点我的观察。希望对想做电商系统的朋友有点用。

01 开发思路：给你基础组件，不锁死业务

MedusaJS的核心想法很简单——不重复造轮子。只提供最基础的电商组件（官方叫commerce primitives），业务逻辑你自己写。

彻底的headless路线，后端只管API，前端随便你用Next.js还是别的。官方反复提“避免供应商锁定”，代码和数据都在你手里，以后不会被平台绑架。

比较有意思的是它引入了Workflows和Modules的概念。Workflows负责把业务流程串起来，还能自动回滚；Modules是可插拔的功能模块。可以在一个项目里加各种自定义功能，不用拆成微服务。整个思路就是：让JS开发者用熟悉的方式快速搭系统，不用学一堆新概念。

02 架构：分层干净，扩展起来不费劲

MedusaJS的架构分了四层，设计挺清爽：

1.客户端层：前端商城 + 管理后台（后台UI也能自己改）。

2.HTTP层：Express写的API路由，Session用Redis。

3.业务逻辑层：Workflows做流程编排，Modules分两类——商务模块（产品、购物车、订单、支付、库存等）和基础设施模块（事件、缓存、文件存储等）。

4.数据层：原生只支持PostgreSQL，其他数据库要写Module适配。

模块之间通过Links松耦合，想换支付、物流或者接ERP，都不费劲。事件系统用Redis的Pub/Sub，订单创建后自动发通知、同步库存，很自然。

整体感觉：小项目单进程能跑，大项目也能横向扩展。比传统单体电商灵活，又没微服务那么乱。

03 代码结构：Monorepo + 约定优于配置，上手不劝退

项目本身是Turborepo管的Monorepo，核心代码都在/packages目录下。结构：

●●●codemy-medusa-store/├── src/│   ├── modules/          # 自定义模块│   │   └── my-feature/│   │       ├── models/│   │       ├── service.ts│   │       └── index.ts│   ├── api/              # 自定义路由│   ├── workflows/        # 自定义流程│   ├── subscribers/      # 事件监听│   └── medusa-config.ts  # 配置入口├── medusa-config.ts└── ...

●●●bashnpx create-medusa-app@latest

然后跑迁移、启动，完事。代码全是TypeScript，模块继承MedusaService基类就自动有CRUD，省了不少样板代码。官方文档翻一遍，基本一天就能把demo改成自己的简单商城。

04 适用场景：从DTC到复杂B2B都能干

官方给的例子覆盖面挺广：

●DTC/B2B商城（多仓库、区域定价、复杂税费）

●多供应商市场（类似外卖平台，带佣金分成）

●订阅制、数字产品交付

●捆绑销售 + ERP同步

●线下POS + 线上统一订单

社区里不少团队用来做带审核流程的B2B平台，或者把现有系统和Medusa打通。只要是需要电商基础能力的场景，它都能干，前提是你愿意亲手写点代码。

05 从框架变成AI原生平台

MedusaJS在AI这块最近动作挺大，2025年底明显把“AI友好”当成了重点方向。

2025年11月推出的Bloom——一个AI电商助手。用自然语言描述需求，比如“做一个支持订阅和区域定价的DTC商城”，就能直接生成完整的storefront、管理后台和后端代码，预览、管理、开发都在一个界面里搞定。

另外AI工具链：

●Claude Code插件（medusa-dev、ecommerce-storefront等skills）：Claude这类AI编码工具直接懂Medusa，能自动生成模块、工作流、Admin组件甚至Storefront页面。

●MCP服务器：把官方文档实时接入Cursor、VS Code等AI编辑器，AI写代码时能随时查最新API。

●Agentic Commerce支持：AI代理可以直接操作商城，比如自动生成产品描述、内容富化，或者实现聊天式下单。

Medusa从“灵活框架”升级成了真正能和AI代理配合的平台。用Bloom+Claude，几分钟就能搭出一个以前要写好几天的复杂功能。

06 优缺点

优点：

●免费，代码全在自己手里，想改就改。

●模块化做得好，扩展性强。

●AI工具链很实用（Bloom和Claude插件能明显提效）。

●文档写得清楚，Discord社区也活跃。

●性能不错，中型店铺够用。

缺点：

●第一次接触Workflow和Module需要适应一下（大概1-2天），不是零基础秒懂。

●开箱功能比较基础，前端商城得自己搭（不过官方有Next.js模板）。

●自托管要配PostgreSQL + Redis，小团队可能觉得运维麻烦（官方也有云托管）。

●插件生态比Shopify小，但自定义能力远超它。

如果你是JS开发者，有一定经验，又不想被平台年费绑住，MedusaJS值得试试。非开发者或者追求零代码的，门槛会高一些。

GitHub：medusajs/medusa