---
title: 快速上手
order: 1
---
## 第一个示例
## 安装 & 引用
在项目中引入 G6 有以下两种方式：NPM 引入；CDN 引入。
### 1 在项目中使用 NPM 包引入
**Step 1:** 使用命令行在项目目录下执行以下命令：
```bash
npm install --save @antv/g6
```
**Step 2:** 在需要用的 G6 的 JS 文件中导入：
```javascript
import G6 from '@antv/g6';
```
### 2 在 HTML 中使用 CDN 引入
```html
// version <= 3.2
// version >= 3.3
```
⚠️ 注意:
- 在 `{$version}` 中填写版本号，例如 `3.3.1`；
- 最新版为 3.3.1，可以在 NPM 查看最新版本；
- 详情参考 Github 分支：https://github.com/antvis/g6/tree/master。
## 快速试用
创建一个 G6 的关系图仅需要下面几个步骤：
1. 创建关系图的 HTML 容器；
2. 数据准备；
3. 创建关系图；
4. 配置数据源，渲染。
### Step 1 创建容器
需要在 HTML 中创建一个用于容纳 G6 绘制的图的容器，通常为 `div` 标签。G6 在绘制时会在该容器下追加 `canvas` 标签，然后将图绘制在其中。
```html
```
### Step 2 数据准备
引入 G6 的数据源为 JSON 格式的对象。该对象中需要有节点（`nodes`）和边（`edges`）字段，分别用数组表示：
```javascript
const data = {
// 点集
nodes: [
{
id: 'node1', // String，该节点存在则必须，节点的唯一标识
x: 100, // Number，可选，节点位置的 x 值
y: 200, // Number，可选，节点位置的 y 值
},
{
id: 'node2', // String，该节点存在则必须，节点的唯一标识
x: 300, // Number，可选，节点位置的 x 值
y: 200, // Number，可选，节点位置的 y 值
},
],
// 边集
edges: [
{
source: 'node1', // String，必须，起始点 id
target: 'node2', // String，必须，目标点 id
},
],
};
```
注意
- `nodes` 数组中包含节点对象。每个节点对象中唯一的、必要的 `id` 以标识不同的节点，`x`、 `y` 指定该节点的位置；
- `edges` 数组中包含边对象。`source` 和 `target` 是每条边的必要属性，分别代表了该边的起始点 `id` 与 目标点 `id`。
- 点和边的其他属性参见链接：[内置节点](/zh/docs/manual/middle/elements/nodes/defaultNode) 和 [内置边](/en/docs/manual/middle/elements/edges/defaultEdge)。
### Step 3 创建关系图
创建关系图（实例化）时，至少需要为图设置容器、宽和高。
```javascript
const graph = new G6.Graph({
container: 'mountNode', // String | HTMLElement，必须，在 Step 1 中创建的容器 id 或容器本身
width: 800, // Number，必须，图的宽度
height: 500, // Number，必须，图的高度
});
```
### Step 4 配置数据源，渲染
```javascript
graph.data(data); // 读取 Step 2 中的数据源到图上
graph.render(); // 渲染图
```
### 最终的结果
## 完整代码
```html
Tutorial Demo
/* 图的画布容器 */
/* 引入 G6 */
```
## React 中使用 G6
如果你想在 React 中使用 G6 ，可以参考我们提供了的 React 中使用 G6 的 Demo。
更多关于 React 中如何使用 G6，请参考 [React 中使用 G6 的文档](/zh/docs/manual/middle/g6InReact)。有任何问题都可以通过页面底部的钉钉交流群和我们沟通，也非常欢迎给我们提 issues 或 PR： https://github.com/antvis/g6/tree/master。
## 更多
本章仅仅介绍了如何安装以及最简单的场景，在 G6 Tutorial 中其他的章节中我们会教会你：
- 实例化图时的常见配置；
- 设置元素（节点/边）属性、样式；
- 设置布局；
- 增加交互；
- 增加动画；
- 使用辅助组件。
想了解更高阶的功能，请参见 [G6 核心概念](/zh/docs/manual/middle/graph)，[G6 高级指引](/zh/docs/manual/advanced/keyconcept/shape-and-properties)。