EverShop
一个基于 GraphQL 和 React 的现代电商平台，TypeScript 优先，专为开发者设计。
智能下载
前往项目主页
该项目暂未提供安装包，请直接访问源代码仓库
用 React 和 GraphQL 搭建的现代电商系统，开箱即用。
核心功能
- 基于 GraphQL 和 React，前后端分离，接口灵活
- TypeScript 优先，代码可维护性强
- 模块化架构，支持扩展和主题定制
- Docker 一键部署，5分钟上线
避坑指南
- •默认使用 SQLite，不适合大规模生产环境，建议换用 PostgreSQL。2. Docker 方式部署需确保 3000 端口未被占用。3. 初次启动会自动创建演示数据，生产部署记得修改默认管理员密码。
适用场景
- 快速搭建 B2C 或 B2B 电商网站
- 为已有系统开发定制化电商模块
详细介绍
EverShop 是一个现代的电商平台，采用 TypeScript 优先，基于 GraphQL 和 React 构建。它提供商品管理、购物车、结账、订单管理等核心电商功能，采用模块化、可完全定制的架构。开发者可以通过扩展模块和主题轻松定制，并利用 Docker 快速部署。与 Magento 等重型平台相比，EverShop 轻量且对开发者友好；相比 Saleor，它提供更纯粹的 React 组件系统，适合快速构建个性化商城。
常见问题与排障 (1)
故障排除为什么 `yarn dev` 在 macOS 上运行失败，而直接用 Node 运行 EverShop 的 bin 脚本却可以正常工作？
这通常是由可执行 JavaScript 文件中的 CRLF 行尾符引起的。shebang 行 #!/usr/bin/env node 变成了 #!/usr/bin/env node\r，因此 Yarn 无法执行它，而 node node_modules/@evershop/evershop/bin/dev/index.js 可以正常工作，因为 Node 是被显式调用的。
将行尾符修复为 LF：
printf '* text=auto eol=lf\n*.js text eol=lf\n' >> .gitattributes
git add --renormalize .
git commit -m "Normalize line endings to LF"
rm -rf node_modules
yarn install
yarn dev在 macOS 上立即仅修复受影响的 bin 文件：
sed -i '' 's/\r$//' node_modules/@evershop/evershop/bin/dev/index.js对 node_modules/@evershop/evershop/bin/ 下其他出错的文件重复执行该 sed 命令。持久修复应随使用 LF 行尾符的软件包一起发布。
临时解决方法：
NODE_ENV=development node node_modules/@evershop/evershop/bin/dev/index.js标签
快速上手
安装软件
双击下载的安装程序，按提示完成安装
步骤1：在终端执行 `curl -sSL https://raw.githubusercontent.com/evershopcommerce/evershop/main/docker-compose.yml > docker-compose.yml`
步骤2：运行 `docker compose up -d` 启动服务
步骤3：浏览器访问 http://localhost:3000 即可使用商店前台，后台管理地址为 /admin
- 步骤1：在终端执行 `curl -sSL https://raw.githubusercontent.com/evershopcommerce/evershop/main/docker-compose.yml > docker-compose.yml`
- 步骤2：运行 `docker compose up -d` 启动服务
- 步骤3：浏览器访问 http://localhost:3000 即可使用商店前台，后台管理地址为 /admin
暂未获取到校验码
该项目暂未在 GitHub Release 页面提供 SHA-256 校验码
SHA256 校验码
暂无校验码
建议从 GitHub Releases 页面直接下载，并自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
进入 docker-compose.yml 所在目录，执行 `docker compose down` 停止并删除容器。如需清理数据，手动删除 docker 卷或本地数据库文件。
无额外依赖
下载后即可直接使用，无需安装其他运行环境
遇到问题？查看下方 FAQ
1 FAQ