baidu /amis

前端低代码框架,通过 JSON 配置就能生成各种页面。

★ 18,889⑂ 2,727👁 228⑃ 6,534● 5,914▤ 104
TypeScriptApache-2.0Created 2019-04-28baidu.github.io/amis/
Download: 6.13.06.13.0 ↓6.13.02025-08-12
+1
Daily
18,889
stars
2,727
forks
228
watchers
6,534
prs
5,914
issues
104
releases

README

文档(国内) |
文档(国外) |
可视化编辑器 |
amis-admin |
爱速搭




  如流群:3395342 |
  如流群2:5511067|




!build
!license
!version
!language

!last



前端低代码框架,通过 JSON 配置就能生成各种后台页面,极大减少开发成本,甚至可以不需要了解前端。

 开发指南

以下是参与开发 amis 才需要看的,使用请看前面的文档。

 如果 github 下载慢可以使用 gitee 上的镜像。

推荐使用 node 12/14/16。npm 7+, 因为用到了 workspaces 功能。

bash
 安装项目 npm 依赖,在 node 12 下会有报错但不影响正常使用。
npm i --legacy-peer-deps

 启动项目,等编译结束后通过 http://127.0.0.1:8888/examples/pages/simple 访问。
npm start


如果是开发编辑器,需要访问 http://127.0.0.1:8888/packages/amis-editor/

 测试

 注意:本地修改代码后,执行测试用例(npm test --workspaces)之前需要先执行npm run build完成编译,因为 jest 并不支持 TypeScript

bash
 安装依赖
npm i --legacy-peer-deps

 执行构建
npm run build

 执行测试用例
npm test --workspaces

 测试某个用例
 为用例名称,比如inputImage
npm test --workspace amis -- -t 

 运行某个单测文件
./node_modules/.bin/jest packages/amis/__tests__/renderers/Form/buttonToolBar.test.tsx

 运行某个单测文件里的某个例子
./node_modules/.bin/jest packages/amis/__tests__/renderers/Form/buttonToolBar.test.tsx -t 'Renderer:button-toolbar'

 查看测试用例覆盖率
npm run coverage

 更新 snapshot
npm run update-snapshot

 更新单个 snapshot
 为用例名称,比如inputImage
npm run update-snapshot --workspace amis -- -t  


 发布版本

bash
 发布内部 registry
npm run publish

 发布外网环境
 先通过一下命令设置版本号
npm run version
npm run release


 如何贡献

请使用分支开发,首先创建分支

    git checkout -b feat-xxx

开发提交后使用 git push --set-upstream origin feat-xxx 创建远程分支。

然后通过系统提示的 https://github.com/xxx/amis/pull/new/feat-xxx 链接来提交 PR。

请采用 typescript 编写,所有合理的改动、新的公用渲染器、用例或者文档的提交都会被接收。

 贡献者



 低代码平台

amis 只能实现前端低代码,如果需要完整的低代码平台推荐使用爱速搭。

Top issues

Discussions

Latest release

6.13.0 6.13.0 2025-08-12
What's Changed
 fix: 事件动作触发失败 by @allenve in https://github.com/baidu/amis/pull/11811
 fix: tree虚拟列表高度未重新计算 by @hzh11012 in https://github.com/baidu/amis/pull/11815
 fix: 表格编辑框-可复制按钮、快速编辑按钮等在非确认模式下换行 by @hzh11012 in https://github.com/baidu/amis/pull/11822
 修复旧版事件动作异常 by @z418577198 in https://github.com/baidu/amis/pull/11823
 feat: 编辑拖拽组件支持容器自动滚动 by @2betop in https://github.com/baidu/amis/pull/11829
 fix: crud双table情况下网格未对齐 by @hzh11012 in https://github.com/baidu/amis/pull/11832
 fix: 修复移动端可能拖入不了组件的问题 by @2betop in https://github.com/baidu/amis/pull/11835
 fix: 修复cards样式异常问题 by @qki

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON