富文本编辑器中表格无法正常合并单元格怎么办？

UI晶晶提问于 2026-03-08 15:11:19 阅读 2

组件

我最近在用 Quill.js 做一个富文本编辑器，加了表格插件之后发现没法合并单元格。点击合并按钮没反应，控制台也没报错。我试过用 quill.getModule('table') 获取模块，但返回的是 undefined，感觉插件根本没加载成功。

我引入插件的方式是这样：

import Quill from 'quill';
import Table from 'quill-table';

Quill.register('modules/table', Table);
const quill = new Quill('#editor', {
  modules: {
    table: true,
    toolbar: [
      ['table']
    ]
  },
  theme: 'snow'
});

是不是这个插件本身不支持合并？还是我哪里配置错了？有没有人用 Quill 成功实现过表格合并功能？

富文本编辑器表格编辑

我来解答赞 0 收藏

反馈

1 条解答

Mr-艺诺 Lv1

Quill.js 原生的表格功能确实不支持合并单元格，你遇到的 getModule('table') 返回 undefined 问题是因为没正确加载插件。我查了一圈，推荐用 quill-table-merge 这个专门支持合并的插件，亲测可用。

试试这个方法：
1. 先安装插件：

npm install quill-table-merge

2. 修改你的引入方式：

import Quill from 'quill';

import { Table, TableMerge } from 'quill-table-merge';



Quill.register({

  'modules/table': Table,

  'modules/tableMerge': TableMerge

});



const quill = new Quill('#editor', {

  modules: {

    table: true,

    tableMerge: true,  // 关键在这里

    toolbar: [

      ['table'],

      ['table-merge-cell']  // 合并按钮要单独加

    ]

  }

});

3. 注意 CSS 也要引入：

import 'quill-table-merge/dist/quill-table-merge.min.css';

常见踩坑点：
- 插件版本要和 Quill.js 版本匹配（比如 Quill 2.x 对应插件 2.x）
- 合并前要先选中多个单元格（很多人以为点一下按钮就能合并）
- 工具栏配置漏掉 table-merge-cell 会导致按钮不显示

这破玩意儿我调了整整一晚上才搞定，文档写得跟迷宫似的。要是还不行，检查下是不是和其他插件冲突了。

2026-03-08 15:18