vxe-gantt 甘特图在 Nuxt 中的集成使用

作者：袖梨 2026-06-03

vxe-gantt 这一 Vue 甘特图组件库专为项目进度管理及任务排期等场景设计。由于它高度依赖浏览器 DOM 环境，在服务端渲染（SSR）过程中无法直接运行，因此在 Nuxt 4 项目里使用时，需要借助官方 Nuxt 模块，并将组件置于标签内，以确保其仅在客户端加载。

下文将从安装、模块配置到具体应用，提供一套完整的集成指引，助力你在 Nuxt 4 项目中迅速运用甘特图组件。

安装

运行以下命令来安装 vxe-gantt 及其依赖的 UI 库、表格核心库以及匹配的 Nuxt 模块：

npm install vxe-pc-ui vxe-table vxe-gantt vxe-pc-ui-nuxt vxe-gantt-nuxt -D

配置 Nuxt 模块

因 vxe-gantt 内部大量调用浏览器 API（例如鼠标拖拽、DOM 尺寸计算、ResizeObserver 等），无法在服务端执行渲染，故所有使用甘特图组件的位置都必须采用标签进行包裹。

// ...
export default defineNuxtConfig({
  // ...
  modules: [
     // ...
    'vxe-pc-ui-nuxt',
    'vxe-gantt-nuxt',
    'vxe-table-nuxt',
    // ...
  ],
  vxeBaseSetting: {
    // global: true // 是否全局加载，如果 false 则按需加载
  },
  vxeTableSetting: {
    // global: true // 是否全局加载，如果 false 则按需加载
  },
  vxeGanttSetting: {
    // global: true // 是否全局加载，如果 false 则按需加载
  },
  // ...
})

使用

支持 Client 模式

<template>
  <ClientOnly>
    <vxe-gantt v-bind="ganttOptions">vxe-gantt>
  ClientOnly>
template><script setup>
import { reactive } from 'vue'const ganttOptions = reactive({
  border: true,
  height: 200,
  columns: [
    { field: 'name', title: '任务名称', minWidth: 200 },
    { field: 'start', title: '开始时间', width: 100 },
    { field: 'end', title: '结束时间', width: 100 }
  ],
  data: [
    { id: 10001, name: 'A项目', start: '2024-03-01', end: '2024-03-04', progress: 3 },
    { id: 10002, name: '城市道路修理进度', start: '2024-03-03', end: '2024-03-08', progress: 10 },
    { id: 10003, name: 'B大工程', start: '2024-03-03', end: '2024-03-11', progress: 90 },
    { id: 10004, name: '超级大工程', start: '2024-03-05', end: '2024-03-11', progress: 15 },
    { id: 10005, name: '地球净化项目', start: '2024-03-08', end: '2024-03-15', progress: 100 },
    { id: 10006, name: '一个小目标项目', start: '2024-03-10', end: '2024-03-21', progress: 5 },
    { id: 10007, name: '某某计划', start: '2024-03-15', end: '2024-03-24', progress: 70 },
    { id: 10008, name: '某某科技项目', start: '2024-03-20', end: '2024-03-29', progress: 50 },
    { id: 10009, name: '地铁建设工程', start: '2024-03-19', end: '2024-03-20', progress: 5 },
    { id: 10010, name: '铁路修建计划', start: '2024-03-12', end: '2024-03-20', progress: 10 }
  ]
})
script>