@antv/x6

中文文档
3.1.8发布于 2026/08/11MITTypeScriptES Module近 30 天下载 42.5万

JavaScript diagramming library that uses SVG and HTML for rendering

原始使用文档
文档目录5 节
  1. ✨ 特性
  2. 🔨 开始使用
  3. 🧑🏻‍💻 本地开发
  4. 📮 贡献
  5. 📄 License

English | 简体中文

X6:图编辑可视化引擎

x6 flow

NPM Package build coverage Package size NPM Downloads MIT License Language PRs Welcome website Ask DeepWiki

antvis%2FX6 | Trendshift

官网文档 • 快速开始 • 图表示例 • 常见问题 • Demo 模板 • Awesome X6

AntV X6 是基于 HTML 和 SVG 的图编辑引擎,提供低成本的定制能力和开箱即用的内置扩展,方便我们快速搭建 DAG 图、ER 图、流程图、血缘图等应用。我们期望开发者基于 X6 可以快速构建自己需要的各种图编辑应用,让流程关系数据变得可控、可交互,以及可视化。

✨ 特性

X6 作为一款专业的图编辑可视化引擎,具有以下特性:

  • 🌱 极易定制:支持使用 SVG / HTML / React / Vue / Angular 定制节点样式和交互,完备的事件系统,可以监听图表内发生的任何事件
  • 🚀 开箱即用:内置 10+ 图编辑配套扩展,如框选、对齐线、小地图等
  • 🧲 数据驱动:基于 MVC 架构,用户更加专注于数据逻辑和业务逻辑
  • 💯 服务端渲染:支持服务端渲染,且有不错的浏览器兼容性。

🔨 开始使用

可以通过 NPM 或 Yarn 等包管理器来安装。

# npm
$ npm install @antv/x6 --save

# yarn
$ yarn add @antv/x6

成功安装之后,可以通过 import 导入 Graph 对象。

<div id="container" style="width: 600px; height: 400px"></div>
import { Graph } from '@antv/x6'

const graph = new Graph({
  container: document.getElementById('container'),
  grid: true,
})

const source = graph.addNode({
  x: 300,
  y: 40,
  width: 80,
  height: 40,
  label: 'Hello',
});

const target = graph.addNode({
  x: 420,
  y: 180,
  width: 80,
  height: 40,
  label: 'World',
});

graph.addEdge({
  source,
  target,
});

一切顺利,你可以得到下面的简单的流程图画布。

🧑🏻‍💻 本地开发

# 安装项目依赖和初始化构建
$ pnpm install

# 启动 examples 查看效果
pnpm run start:examples

📮 贡献

感谢所有为这个项目做出贡献的人,感谢所有支持者!🙏

Contribution Leaderboard
  • 问题反馈:使用过程遇到的 X6 的问题,欢迎提交 Issue,并附上可以复现问题的最小案例代码。
  • 贡献指南:如何参与到 X6 的开发和贡献。
  • 想法讨论:在 GitHub Discussion 上或者钉钉群里面讨论。

📄 License

MIT.

版本与发布记录

@antv/x6 共发布 429 个版本,首次发布于 2019/12/01;过去 12 个月发布了 18 个版本。

版本发布日期距今
3.1.8latest2026/08/112 个月前
3.3.72026/05/195 个月前
3.2.72026/05/195 个月前
3.1.72026/03/187 个月前
3.1.62026/02/049 个月前
3.1.52026/01/279 个月前

其他发布通道:@antv/[email protected] → 1.35.1,beta → 3.1.4-beta.1。

关于 @antv/x6 的常见问题

@antv/x6 是什么?

JavaScript diagramming library that uses SVG and HTML for rendering

如何安装 @antv/x6?

在项目目录运行 npm install @antv/x6,或使用 pnpm add / yarn add / bun add。

@antv/x6 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@antv/x6 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@antv/x6 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@antv/x6 可以商用吗?

@antv/x6 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@antv/x6 的下载量有多少?

根据 npm 官方下载统计,@antv/x6 在 2026/10/06 – 2026/11/04 这 30 天内被下载 425,077 次,日均约 14,169 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@antv/x6 还在维护吗?

最新版本 3.1.8 发布于 2026/08/11(2 个月前);至今共发布 429 个版本,其中过去 12 个月发布了 18 个;首次发布于 2019/12/01。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。