Wekan 数据导入实战指南：CSV、JSON、Excel 三格式快速完成迁移

Wekan 数据导入实战指南CSV、JSON、Excel 三格式快速完成迁移【免费下载链接】wekanThe Open Source kanban, built with Meteor. GitHub issues/PRs are only for FLOSS Developers, not for support, support is at https://wekan.fi/commercial-support/ . PR source translation to imports/i18n/data/en.i18n.json, other translations at https://app.transifex.com/wekan/wekan项目地址: https://gitcode.com/GitHub_Trending/we/wekanWekan 的导入功能覆盖了三种典型的数据来源旧看板导出的 JSON、Trello 的备份文件、以及 CSV/TSV/Excel 表格。本文按“你的数据现在在哪”分场景给出操作路径帮你快速判断该用哪种格式、走哪个入口并把整个看板完整迁移进来。先快速判断我该用哪种格式导入大多数人在导入前的第一个问题就是格式选择。对照你的数据来源30 秒定位方案你的数据现在在哪推荐格式Wekan 导入入口能带过来的内容Trello 导出的 JSONJSONTrello 导入添加看板 → 从 Trello 导入列表、卡片、标签、评论、成员旧 Wekan 实例导出的 JSONJSON从之前的导出导入添加看板 → 从之前的导出导入列表、卡片、泳道、附件等完整结构Excel / CSV 表格CSV、TSV 或 Excel(.xlsx)添加看板 → 从 CSV/TSV 导入 / 从 Excel 导入每行一张卡片含负责人、标签、日期数据库里的历史数据先导出为 JSON 再导入添加看板 → 从之前的导出导入同上入口统一在用户名 → 所有看板 → 添加看板 → 导入弹窗里会列出全部受支持的格式。场景一数据在 Trello整体迁移看板适合把整个 Trello 项目搬进 Wekan一条命令都不用写。在 Trello 中打开看板菜单显示菜单 → 其他 → 打印和导出 → 导出 JSON保存文件。登录 Wekan进入导入弹窗选择从 Trello 导入把导出的 JSON 内容粘贴进输入框点击导入。如果看板里有成员Wekan 会让你把 Trello 用户映射到现有的 Wekan 用户用户名一致时会自动匹配。导入完成后直接打开新看板。两个实用提示尽量让 Wekan 用户与 Trello 用户同名成员映射基本可以零手工。活动历史谁在何时做了什么不会被导入附件会被下载并托管到你的服务器附件很多时耐心等待。完整的 Trello 迁移说明见 Trello 迁移文档CSV/TSV 列名对照等细节参考 官方导入导出文档。场景二数据在表格里批量建卡3 步完成 CSV/TSV 建板CSV 导入的核心规则只有一条每行 一张卡片第一行是列名。列名不区分大小写支持这些字段列名含义title卡片标题必填description卡片描述stage/status/state所属列表owner、members负责人 / 参与成员用户名label/labels标签due date、start date、finish date截止时间、开始时间、完成时间操作步骤按上表整理文件。仓库里自带了可直接试跑的样例board-import.csv 和 board-import.tsv建议直接下载对照。进入导入弹窗选择从 CSV/TSV 导入上传文件Wekan 会自动解析。预览确认后点击导入卡片即按stage列落到对应列表。前端解析在 import 组件落库逻辑在 csvCreator.js 和通用导入器 import.js。列名写错不会报错而是被忽略导入后务必抽查一张卡片的字段是否齐全。直接导入 Excel (.xlsx) 文件不想先把 Excel 另存为 CSV 的话可以直接选从 Excel (.xlsx) 导入。文件需要是 Wekan 风格的.xlsx与看板设置 → 导出 → Excel产生的列一致Title、Description、Status/List、Members、Labels、日期、自定义字段第一行为表头。文件在服务端解析后走与 CSV 相同的导入引擎因此看板可以Excel 导出 → 再导入往返迁移。注意 Excel 导入不做成员自动映射需要导入后再补。详见 Excel 导入文档。VBA REST API从 Excel 批量建卡和改卡如果你的 Excel 里要反复批量更新已有看板而不是首次导入可以走 REST API用管理员账号登录换令牌curl -H Content-type:application/json \ http://localhost:3000/users/login \ -d { email: myemail.com, password: mypassword }返回中的token即为后续请求的AUTH-TOKEN。在 Excel 里用 VBA配合 VBA-Web / VBA-JSON 等库逐行读取表格调用 PUT 更新卡片curl -H Authorization: Bearer AUTH-TOKEN \ -H Content-type:application/json \ -X PUT \ http://localhost:3000/api/boards/BOARD-ID/lists/LIST-ID/cards/CARD-ID \ -d { title: 新卡片标题, description: 卡片描述 }带附件的数据可以先把附件转成 Base64 再经 API 上传。接口细节以 REST API 文档 为准。场景三数据在数据库里整库备份一键恢复JSON 一键还原整个看板Wekan 的 JSON 导出包含泳道、列表、卡片、自定义字段乃至附件以 Base64 内嵌是保真度最高的迁移格式。从原实例导出看板菜单选择导出 → JSON超大看板可选JSON不含附件以避免 JSON 序列化溢出。新实例进入导入弹窗选择从之前的导出导入粘贴 JSON点击导入。JSON 体积很大时用剪贴板更稳cat board.json | xclip -se c在输入框中右键 → 以文本粘贴即可。顺手做一份可查询的副本如果对导入数据要做分析或归档可以把导出 JSON 灌进 SQLite3sqlite3 wekan.db .mode json .load wekan-export-board.json board导入后管理与校验抽查关键字段卡片数量、列表分布、成员归属、截止日期。CSV/Excel 导入最容易在列名拼写上丢字段。补成员映射未映射的成员会以占位用户形式存在看板管理员之后可以在侧边栏成员头像弹窗里再映射到真实用户。批量操作按住Ctrl点选多张卡片可批量移动、归档、加标签快速整理刚导入的数据。怎么选3 种方式 10 秒速查判断条件选它来源是 Trello 或旧 Wekan 看板要原样整体搬JSON 导入Trello 导入 / 从之前的导出导入来源是表格一行一个任务首次批量建板CSV/TSV 导入或直接导入 .xlsx表格需要反复批量增改已有卡片REST API配合 VBA 或脚本一句话总结能整体搬就别拆必须拆就用表格要长期同步就走上 API。各格式入口、列名规则和限制条件完整对照 官方导入导出文档。【免费下载链接】wekanThe Open Source kanban, built with Meteor. GitHub issues/PRs are only for FLOSS Developers, not for support, support is at https://wekan.fi/commercial-support/ . PR source translation to imports/i18n/data/en.i18n.json, other translations at https://app.transifex.com/wekan/wekan项目地址: https://gitcode.com/GitHub_Trending/we/wekan创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考