开源多维表格SmartTable v1.4.0 来啦！这次带来了文档功能
发布日期：2026-05-25
写在前面
距离上个版本发布才过去一周多，开源类“飞书多维表格”系统SmartTable 又迎来了 v1.4.0。
这次更新的核心就一个字——写。
之前 SmartTable 能帮你管数据、做表单、建仪表盘，但一直缺一个正经的"写文档"的地方。很多用户反馈说，数据表里记录的是结构化数据，但项目里总有些需要长篇大论说明的东西，比如需求文档、会议纪要、项目方案……这些内容放表格里不合适，不放又没地方放。
所以，v1.4.0 我们把文档管理模块给安排上了。
下面一个一个来说。
一、文档管理：边管数据边写文档
文档跟 Base 走，权限不用重复配
新增加的文档功能是挂在 Base（多维表）下面的。什么意思呢？就是你建了一个项目 Base，里面既可以有数据表、仪表盘，现在还可以有文档了。
而且权限是通的——你对这个 Base 有什么权限，对里面的文档就有什么权限。不用给文档单独再设一遍谁能看谁不能看，省事。
编辑器：该有的都有，够用
编辑器用的是华为团队开源的基于Quill的富文本编辑器TinyEditor，一个业界用得挺多的富文本引擎（感谢TinyEditor团队的贡献）。功能上覆盖了日常写文档的基本需求：
- 文字排版：加粗、斜体、标题、列表这些基础操作肯定有
- 插入表格：写方案、排计划的时候表格是刚需，现在文档里也能插了
- 插入图片：在文档当中插入图片
- Markdown 支持：如果你习惯用 Markdown 写东西，也可以直接在编辑器里写，实时渲染
- 文档标题实时预览：支持在文档的时候，实时预览文档的标题大纲，并可以快速点击导航定位，方便阅读文档指定章节信息
- 键盘快捷键：写文档的时候手不离键盘是最舒服的，Ctrl+S 顺手保存，不用去点按钮
版本历史：手滑了也不要慌
写文档最怕什么？怕改了半天发现还不如上一版好，但又找不回来了。
文档模块带了版本历史功能。每次保存都会生成一个版本记录，你可以随时回溯到任意历史版本。而且版本列表里会显示是谁保存的，方便团队协作的时候知道每个版本的来龙去脉。
PDF 导出：写完直接出文件
文档写好了，有时候需要发给别人看或者打印出来。现在直接点一下就能导出成 PDF 文件，排版样式基本能保持跟编辑器里看到的一致。
二、Docker 部署大简化：一个容器全搞定
老用户应该知道，之前用 Docker 部署 SmartTable 需要启动两个容器——一个跑应用，一个跑 Redis。虽然也不算多复杂，但对于只是想快速体验一下的人来说，还是有点门槛。
这次我们把 Redis 直接内嵌到了应用容器里，现在只需要一个容器就能跑起来了。
docker run -d \
--name smarttable \
-p 80:80 \
-v smarttable_data:/app/data \
-v smarttable_uploads:/app/uploads \
-v smarttable_redis:/data/redis \
ygbinac/smarttable:latest
一行命令，搞定。
对于想快速搭起来试试看的朋友，这个改动应该能省不少事。
- 或者使用 docker compose ，只需创建以下 docker-compose.yml ：：
services:
smarttable:
image: ygbinac/smarttable:latest
container_name: smarttable
ports:
- "80:80"
volumes:
- smarttable_data:/app/data
- smarttable_uploads:/app/uploads
- smarttable_redis:/data/redis
restart: unless-stopped
volumes:
smarttable_data:
smarttable_uploads:
smarttable_redis:
三、一些不那么显眼但很有用的改进
除了上面两个大块，这次还顺手修了一些东西：
- 时区处理优化：修了几个时区不一致导致的 bug，特别是文档版本创建时间的显示问题。另外，为了方便用户在不同时区直接使用，我们实现了前端页面根据用户时区自动调整时间显示的功能。
- API 文档补齐了：文档模块的所有接口都加上了 Swagger 注释，现在在
/apidocs页面能看到完整的接口说明，前后端联调的时候方便不少。 - 修了几个小 bug：列表选中状态异常、乐观锁校验逻辑错误、PDF 导出图片 URL 路径不对……该修的都修了。
四、SmartTable 是个什么项目？
看到这里，可能有些朋友是第一次听说 SmartTable，这里简单介绍一下。
SmartTable 是一个开源的多维表格管理系统，说白了就是一个可以自己搭的"类 Airtable、飞书多维表格"系统。它把数据表格、表单收集、仪表盘分析、文档管理这些功能整合到了一起，适合用来做：
- 项目管理
- 数据收集和汇总
- 团队协作
- 企业级应用
- 轻量级 CRM
- 轻量级 MES
- 轻量级 WMS
- 轻量级 ERP
- 个人知识管理
核心特性一览
数据管理
- 26+ 种字段类型：文本、数字、日期、单选、多选、附件、关联、自动编号、评分等
- 6+ 种视图：表格、看板、日历、甘特图、画廊、表单
- Excel 智能导入创建表
- 数据导入导出
表单与分享
- 公开表单分享（匿名提交、验证码保护）
- 数据收集与统计分析
仪表盘
- 可视化图表展示
- 多种行业模板
- 实时数据组件
文档管理（v1.4.0 新增）
- 富文本编辑、Markdown 支持
- PDF 导出、版本历史
- 与 Base 权限打通
协作与安全
- 实时多人在线协作
- JWT 认证、API 限流
- XSS/SQL 注入防护
- 敏感信息日志脱敏
部署
- 支持 Docker 单容器部署
- 小白用户友好的一键运行包（支持Windows/Linux/macOS 等环境下一键运行，无需安装依赖）
技术栈
| 层面 | 技术 |
|---|---|
| 后端 | Python 3.11+、Flask 3.0、SQLAlchemy 2.0、PostgreSQL、Redis |
| 前端 | Vue 3、TypeScript、Element Plus、Pinia、Vue Router |
| 部署 | Docker、PyInstaller、Nuitka |
五、关注作者
SmartTable 是一个个人开源项目，作者是程序员吕洞宾。项目完全开源，代码都在 GitHub 和 Gitee 上，欢迎 star、fork、提 issue，一起参与建设。
如果你觉得这个项目对你有帮助，或者想了解更多关于 SmartTable 的开发故事、技术分享，可以关注作者在这些平台上的账号：
| 平台 | 账号 / 地址 |
|---|---|
 GitHub（主仓库） |
https://github.com/ldbinac/smart_table |
 Gitee（国内镜像） |
https://gitee.com/binac/smart_table |
 CSDN |
程序员吕洞宾 |
 稀土掘金 |
程序员吕洞宾 |
 知乎 |
程序员吕洞宾 |
 微信公众号 |
程序员吕洞宾 |
关注不迷路，持续更新中～
SmartTable v1.4.0，让数据管理和文档编写合二为一。
微信公众号
稀土掘金
知乎
老铁们，GitHub 点个 Star 就是最大的支持！
SmartTable v1.5.2 更新说明
新增功能 (New Features)
表格内容全局搜索：新增表格内全局搜索能力，方便快速定位记录
单元格自动合并：支持开启相邻相同内容单元格自动合并展示
行冻结/取消冻结：表格视图右键菜单新增行冻结与取消冻结操作
主键字段默认描述：为主键（索引）字段添加默认描述，并限制隐藏操作
优化改进 (Improvements)
Bug 修复 (Bug Fixes)
工作流自动化引擎 (Workflow Engine) 
Webhook 投递管理 (Webhook Delivery) 系统
公式字段功能完善
仪表盘分享功能
平台能力
工程与构建
主从表与树形层级 
站内信通知系统 
协同编辑与并发控制
交互与体验优化
权限与安全
第三方应用接入 
日期输入与字段格式增强
地理位置字段 
工作流与仪表盘
通知能力增强
树形视图增强
部署与依赖优化
Excel 导入增强
数据表文件夹管理
成员管理增强