Wekan 数据导入指南批量建卡与看板迁移的三条路径【免费下载链接】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把数据迁入 Wekan 的主路只有三条用 CSV/TSV 表格批量建卡、用 JSON 导出文件做 Wekan 数据导入恢复旧看板、把 Excel 台账经 .xlsx 直导或 REST API 接入看板。本文按你的真实场景拆解这三条路覆盖 Wekan 导入的完整操作路径和容易踩的坑按数据来源选对应做法即可。场景一新建看板批量录入任务——CSV/TSV 三步导入新项目启动时你手里往往已有一张任务清单想把它整批变成 Wekan 里的卡片CSV/TSV 导入是最直接的路径。先把表头和列名写对Wekan 以文件第一行作为表头列名拼写要和仓库自带的示例文件一致docs/Features/ImportExport/CSV/board-import.csv同目录还有 TSV 版。常用列为Title卡片标题、Description描述、Stage落入哪个列表、Owner/Members负责人与参与人填 WeKan 用户名、Labels标签、Due Date/start date/finish date日期示例用 05/06/2020 这种月/日/年格式。不需要的列可以留空但列名本身不能写错。上传文件预览后确认导入点页面右上角用户名 → “所有看板” → “添加看板” → “导入” → “从 CSV/TSV 导入”选择文件后页面会先解析出预览核对列表和卡片无误再点“导入”。解析与成员匹配的实现在前端 client/components/import/ 和后端 models/csvCreator.js预览不符合预期时优先回头检查表头。导入后整理多选卡片批量处理导入完成后每行数据已变成卡片多选卡片可以批量移动到其他列表、归档或打标签比逐张点开快得多。场景二实例迁移或换服务器——用 JSON 导出文件恢复看板换实例、换服务器后找回旧数据靠的是之前导出的看板 JSON 备份。JSON 里包含列表、卡片、标签附件也以内嵌 base64 形式保存属于整看板的完整数据导入而不是扁平表格。粘贴并导入点用户名 → “所有看板” → “添加看板” → “导入” → “从之前的导出导入”把 JSON 全文粘进输入框点“导入”即可还原看板。大文件先入剪贴板再粘贴 ⚡JSON 很大时直接复制粘贴容易出错。Linux 上可先把文件装进剪贴板再到输入框里右键选择“粘贴为文本”cat board.json | xclip -se c— 一条命令把整个导出文件放入剪贴板。注意两点附件在 JSON 中是 base64 文本附件多的看板导出文件会明显变大导出时可选“JSON不含附件”导入后再补传附件若旧实例还能正常访问直接带附件导出最省事。可选把 JSON 灌进 SQLite 做查询分析不想打开 Wekan、想用 SQL 直接查导出数据时可以把它加载进 SQLite3sqlite3 wekan.db .mode json .load wekan-export-board.json board三条命令依次打开本地库、切换 JSON 模式、把导出文件读成 board 表之后就能对卡片字段写普通 SELECT。场景三Excel 台账接入看板——.xlsx 直导或 REST API数据源是 Excel 台账时按“一次性搬完”还是“持续同步”选下面两种做法。直接导入 WeKan 格式的 .xlsx “导入”菜单里有“从 Excel (.xlsx) 导入”选项它吃 WeKan Excel 导出的格式第一行为表头列与 Excel 导出一致包括 Title、Description、Status/List、Members、Labels、日期、自定义字段。表格在服务端解析后走与 CSV/TSV 相同的导入引擎所以导出、迁移、再导入可以往返使用。限制是 Excel 导入不自动映射成员列导入后需要手动给卡片补负责人一次性迁移通常可接受。需要持续同步VBA 调 REST API台账周期性更新、要求看板跟着走时用 WeKan 的 REST API先登录换 token再凭 token 建卡或改卡。在 VBA 里可以直接发 HTTP 请求也可以调用系统里的 curl.exe。登录示例换成你的地址和账号curl -H Content-type:application/json http://localhost:3000/users/login \ -d { email: myemail.com, password: mypassword }返回 JSON 中的token字段放入后续请求的Authorization: Bearer头向boards/.../lists/.../cards/...发 PUT 即可更新卡片标题、描述等字段台账里带附件的话可先把文件转 base64 再走附件接口上传。各接口的路径与字段说明见 docs/API/REST-API.md。常见坑与注意事项 ⚠️表头与日期CSV/TSV 第一行必须是表头列名拼写需与示例一致日期格式不识别时对应日期字段会是空。成员不映射Owner / Members 按 WeKan 现有用户名匹配匹配不到的人不会出现在卡片上导入后手动补Excel 导入的成员列完全不自动映射。附件JSON 恢复依赖导出文件里的 base64 数据文件过大时改选“不含附件”导出导入后再补传。导入总是新建看板所有导入路径都是生成新看板不会覆盖已有看板已有数据想挪位置也是走“导出再导入”。怎么选导入方式数据来源推荐方式适用场景CSV/TSV 表格从 CSV/TSV 导入新项目批量录入任务旧 WeKan 导出文件从之前的导出导入换实例后完整恢复看板Excel 台账从 Excel (.xlsx) 导入或 REST API一次性迁移或定期同步Trello、Jira 等工具导入菜单中对应选项从其他看板工具迁移结论就三句新项目建卡走 CSV/TSV换实例走 JSON 恢复台账要持续更新就接 REST API。更多导入导出主题可查阅仓库 docs/Features/ImportExport 目录下的分格式文档。【免费下载链接】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），仅供参考 
长河君 · 2026/9/6 20:24:17 · 阅读 1.2k Wekan 数据导入指南：批量建卡与看板迁移的三条路径
Wekan 数据导入指南批量建卡与看板迁移的三条路径【免费下载链接】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把数据迁入 Wekan 的主路只有三条用 CSV/TSV 表格批量建卡、用 JSON 导出文件做 Wekan 数据导入恢复旧看板、把 Excel 台账经 .xlsx 直导或 REST API 接入看板。本文按你的真实场景拆解这三条路覆盖 Wekan 导入的完整操作路径和容易踩的坑按数据来源选对应做法即可。场景一新建看板批量录入任务——CSV/TSV 三步导入新项目启动时你手里往往已有一张任务清单想把它整批变成 Wekan 里的卡片CSV/TSV 导入是最直接的路径。先把表头和列名写对Wekan 以文件第一行作为表头列名拼写要和仓库自带的示例文件一致docs/Features/ImportExport/CSV/board-import.csv同目录还有 TSV 版。常用列为Title卡片标题、Description描述、Stage落入哪个列表、Owner/Members负责人与参与人填 WeKan 用户名、Labels标签、Due Date/start date/finish date日期示例用 05/06/2020 这种月/日/年格式。不需要的列可以留空但列名本身不能写错。上传文件预览后确认导入点页面右上角用户名 → “所有看板” → “添加看板” → “导入” → “从 CSV/TSV 导入”选择文件后页面会先解析出预览核对列表和卡片无误再点“导入”。解析与成员匹配的实现在前端 client/components/import/ 和后端 models/csvCreator.js预览不符合预期时优先回头检查表头。导入后整理多选卡片批量处理导入完成后每行数据已变成卡片多选卡片可以批量移动到其他列表、归档或打标签比逐张点开快得多。场景二实例迁移或换服务器——用 JSON 导出文件恢复看板换实例、换服务器后找回旧数据靠的是之前导出的看板 JSON 备份。JSON 里包含列表、卡片、标签附件也以内嵌 base64 形式保存属于整看板的完整数据导入而不是扁平表格。粘贴并导入点用户名 → “所有看板” → “添加看板” → “导入” → “从之前的导出导入”把 JSON 全文粘进输入框点“导入”即可还原看板。大文件先入剪贴板再粘贴 ⚡JSON 很大时直接复制粘贴容易出错。Linux 上可先把文件装进剪贴板再到输入框里右键选择“粘贴为文本”cat board.json | xclip -se c— 一条命令把整个导出文件放入剪贴板。注意两点附件在 JSON 中是 base64 文本附件多的看板导出文件会明显变大导出时可选“JSON不含附件”导入后再补传附件若旧实例还能正常访问直接带附件导出最省事。可选把 JSON 灌进 SQLite 做查询分析不想打开 Wekan、想用 SQL 直接查导出数据时可以把它加载进 SQLite3sqlite3 wekan.db .mode json .load wekan-export-board.json board三条命令依次打开本地库、切换 JSON 模式、把导出文件读成 board 表之后就能对卡片字段写普通 SELECT。场景三Excel 台账接入看板——.xlsx 直导或 REST API数据源是 Excel 台账时按“一次性搬完”还是“持续同步”选下面两种做法。直接导入 WeKan 格式的 .xlsx “导入”菜单里有“从 Excel (.xlsx) 导入”选项它吃 WeKan Excel 导出的格式第一行为表头列与 Excel 导出一致包括 Title、Description、Status/List、Members、Labels、日期、自定义字段。表格在服务端解析后走与 CSV/TSV 相同的导入引擎所以导出、迁移、再导入可以往返使用。限制是 Excel 导入不自动映射成员列导入后需要手动给卡片补负责人一次性迁移通常可接受。需要持续同步VBA 调 REST API台账周期性更新、要求看板跟着走时用 WeKan 的 REST API先登录换 token再凭 token 建卡或改卡。在 VBA 里可以直接发 HTTP 请求也可以调用系统里的 curl.exe。登录示例换成你的地址和账号curl -H Content-type:application/json http://localhost:3000/users/login \ -d { email: myemail.com, password: mypassword }返回 JSON 中的token字段放入后续请求的Authorization: Bearer头向boards/.../lists/.../cards/...发 PUT 即可更新卡片标题、描述等字段台账里带附件的话可先把文件转 base64 再走附件接口上传。各接口的路径与字段说明见 docs/API/REST-API.md。常见坑与注意事项 ⚠️表头与日期CSV/TSV 第一行必须是表头列名拼写需与示例一致日期格式不识别时对应日期字段会是空。成员不映射Owner / Members 按 WeKan 现有用户名匹配匹配不到的人不会出现在卡片上导入后手动补Excel 导入的成员列完全不自动映射。附件JSON 恢复依赖导出文件里的 base64 数据文件过大时改选“不含附件”导出导入后再补传。导入总是新建看板所有导入路径都是生成新看板不会覆盖已有看板已有数据想挪位置也是走“导出再导入”。怎么选导入方式数据来源推荐方式适用场景CSV/TSV 表格从 CSV/TSV 导入新项目批量录入任务旧 WeKan 导出文件从之前的导出导入换实例后完整恢复看板Excel 台账从 Excel (.xlsx) 导入或 REST API一次性迁移或定期同步Trello、Jira 等工具导入菜单中对应选项从其他看板工具迁移结论就三句新项目建卡走 CSV/TSV换实例走 JSON 恢复台账要持续更新就接 REST API。更多导入导出主题可查阅仓库 docs/Features/ImportExport 目录下的分格式文档。【免费下载链接】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），仅供参考