本文由 Huifer 撰写，独立开发者且是 TanStack Ship 维护者。 在 2025 至 2026 年间，我发布了三个从电子表格到 SaaS 的转换项目：一个包含 47 个工作表的库存工具、一个 1.2 万行的定价分析器，以及一个取代接待员 Google Sheets 交接的医疗工具。每次迁移遵循相同七个阶段，碰到同样三种权衡。这就是指南内容，附带 TanStack Ship 上的开发代码和警示。

验证来源： Google Sheets API quotas · Microsoft Excel import limits · Stripe Billing metering · Better Auth · Cloudflare D1 limits · OWASP A01 Broken Access Control · TanStack Start · CSV RFC 4180

最后更新：2026-05-14 · 更新日志

Spreadsheet to SaaS：7 个阶段和 3 个诚实的权衡

太长不看： 在 2025 至 2026 年间，过程包含：盘点、选模型、达成体验对等再优化、搞定登陆计费、阶段迁移、通知与停用、统计验证。3 个权衡点：上线时间与体验间取舍、两成坚决不换的老用户，以及应被永远保留在老公式里的极端功能。第 0 至 3 阶段耗时极短；第 4 至 6 需几周工夫；结尾的 7 则是长期持续工程。

当电子表格无法继续扩展时（诚实的触发因素）

大部分创业者等了太长时间。有五个并发编辑人员并出现 30 秒卡顿延迟时，技术债务早已堆积如山。以下是三个报警节点，注意没有一个是“文件太大”：

5 个席位正在编辑同一个文件

并发下，Google Sheets API 的写入会导致数据不可预见地被覆写遮蔽。危险信号：“我刚才改了一栏指令，转头就复原了。” 此时你的体系不再具备任何可信度。

审计追踪需求

电子表格完全没有溯源记录机制。监管或客户来信问询“谁在 3 月 14 日修改相关信息”，你迫切需要只允许增加数据的审计事件操作追踪。详情阅读 SaaS 身份验证指南。

单客户行数 > 5,000

跨过五千记录红线之后，VLOOKUP 功能时常中断超时，数据经常在保存阶段完全丢失无影。曾有一个一万两千行的程序竟然需要长达 14 秒等待重算。若在底层有明确约束 schema 的 Cloudflare D1 执行其处理则毫秒即搞定。

第 0 阶段：盘点电子表格（你真正在发布的东西）

最易被直接忽略掉跳过去的初始动作。看一眼几排表名便断定任务非常直观化是最大的幻觉。曾有的实际库管软件，足有四十七张列表，十一张记录长达十八个月再无任何触动。

单元格、公式与命名范围

必须极度深挖所有命名规则与逻辑链接。通过脚本程序去请求调阅 Google Sheets API 获取详尽无死角的数据报册：包括文档表名、末期更改日、最终编辑身份、表达式条数合计、外联总数等关键数值。

VBA / Apps Script / Sheets 宏

隐秘代码是陷阱巨无霸。一万两千多行的工程内部藏匿有改变即发作运转的多达四十七条代码执行段网络。如果不悉心做提前梳理识别而冲进改写里头则必然会凭空增加至少一个月的长工期。列清单进行仔细审查去留淘汰等处置。

外部数据提取和查询

譬如 IMPORTRANGE 或 QUERY——凡是对系统库池外伸手求数据的均属危在旦夕之隐式绑线关系。正规的新系统解决通道应当走系统集成直连数据源，而不靠前端临时抓数之法。

第 1 阶段：先挑选数据模型，后选择框架

本迁移通病首推错误太急订架选技术。必须先重整业务实体关联逻辑。旧表本是一本已失去任何强有法度的烂系统；要回塑真身即应当通过重构。

是实体，而不是选项卡（Tab）

单薄名叫“Q3_inventory”的文本栏称定不住业务基元重量。正解实体归为 Product 和 Warehouse。面层与后台要映射列栏化作铁打固定格式类型。并要以此作为 CSV RFC 4180 的高准法则来逼导入导出动作。

在边缘节点完成 schema 验证

将拦检门卡挪到距边最靠近外界的 Edge 区位拦截不应交出内部库去审核工作。利用 TanStack Start 后端脚本把两毫秒内执行的 Zod 校据方案拦截住污染源，救助以后再去清污排难的人力大消耗。

迁移加载途径：CSV / SQL 转储 / 实时同步

最初三大可取途径：全量倒换格式的 CSV、挂至 Postgres 提供的 SQL 倒拉、或者借 Google Sheets API 在线同协齐进。低至不足五万规模者采用纯 CSV 可获取制霸速度优势。下为导入系统代码演示操作段：

// src/server/import/sheets-to-d1.ts
import { z } from "zod";

const ProductRow = z.object({
  sku: z.string().min(1).max(64),
  name: z.string().min(1).max(200),
  warehouse_id: z.string().uuid(),
  on_hand: z.number().int().min(0),
  unit_cost_cents: z.number().int().min(0),
});

export type ProductRow = z.infer<typeof ProductRow>;

export async function importProducts(rows: unknown[], tenantId: string) {
  const validated = z.array(ProductRow).parse(rows);
  const stmt = db.prepare(
    `INSERT INTO products (id, tenant_id, sku, name, warehouse_id, on_hand, unit_cost_cents, updated_at)
     VALUES (?, ?, ?, ?, ?, ?, ?, unixepoch())
     ON CONFLICT (tenant_id, sku) DO UPDATE SET
       name = excluded.name,
       on_hand = excluded.on_hand,
       unit_cost_cents = excluded.unit_cost_cents,
       updated_at = excluded.updated_at`
  );
  const batch = validated.map((r) =>
    stmt.bind(crypto.randomUUID(), tenantId, r.sku, r.name, r.warehouse_id, r.on_hand, r.unit_cost_cents)
  );
  await db.batch(batch);
  return { imported: validated.length };
}

带有 ON CONFLICT 条约保证动作皆会服从安全幂等不错操作机制无后患。tenant_id 是搭建多租户边界的隔离防窜钥匙。

第 2 阶段：优先实现体验同级对等，其次改良

抑制一来便出改革神颜界面的本能猛欲望。惯用旧俗操作之群众手中拥有定式极度坚硬的固定使用指法定型记忆惯态；核心第一要诀在于只提供具备全面功能视效平等的原初镜像（UX parity），其他操作提升可安排在随后数周开展。

必须得留定维持住的设计

保留列排序顺次布局、最初始的标题名，并在允许的环境重现常用键盘按键反馈。

必须断然删除出局的旧事物

超 18 个月以上没有被人探看甚至查点之区域。包含高达六色且错位之注释区部分。此外并直接拆卸从来无用户探其门路的废旧概括统计视窗板。

必定换血去替换的核心部件

查找及搜罗引擎设计。昔日的 VLOOKUP 实属在感官操作中体验不佳的笨拙设计；滤器——以往仅属无直接外展UI界面的可怜选项格；动作操作归真核录机制日志板。前诉这些将为推开换 SaaS 这个大道的最稳厚坚实且纯正的地基逻辑基础与事实理由点所在。

第 3 阶段：认证及避开“按人头”吸血圈套

此节点一旦走歪系统将只配摆作为玩具壳成品。

孤狼微初创，Better Auth 远抛 Clerk 几条街

采用 Better Auth 便极超在对向大用依赖重模式外包向 Clerk 能优享良上数几等优选性价比和自由适度及大掌控空间力度。纯不绑月人头（MAU）强收费；完全对接原生老旧工具思维最紧致认可“通过谷歌验证通行全阵位之信赖感”。整合进其提供原装 OAuth 服务等同交付至用户最高舒适体感平滑跨度衔承。

// src/server/auth/config.ts
import { betterAuth } from "better-auth";
import { drizzleAdapter } from "better-auth/adapters/drizzle";
import { db } from "@/server/db";

export const auth = betterAuth({
  database: drizzleAdapter(db, { provider: "sqlite" }),
  emailAndPassword: { enabled: true, requireEmailVerification: true },
  socialProviders: { google: { clientId: process.env.GOOGLE_CLIENT_ID!, clientSecret: process.env.GOOGLE_CLIENT_SECRET! } },
  user: { additionalFields: { tenant_id: { type: "string", required: true } } },
});

Stripe 落款项定位与计钱收费收额：坐户点流结账法抑及整件固定包裹价签款

统观全局常走三种收费主流定略：依赖人工数分点交金制度、依靠按需包月之制单付（适应中小班底）以及根据点流查询次数据结消费流点点滴滴。库存管理实例之中定月 $29 单锁全包式夺魁定鼎，正是它操人少只有一二两；按数量来要结钱就显得得不偿失平端抬贵并受人恶拒了。Stripe Billing 按量收费通查集对所连系统接流 API 有指教阐明；同时在此并读关于各类 SaaS 之定价模式实录长篇之解要略指南及推荐信览全本解忧参决。

跨地域全境及退返走管办之连税法算统归税务系统整合及管用及落定

曾靠独立格另开一条单记手工计结票据款的古早方法早做烟消云散休去。借助入装 Stripe Tax 辅件模快并包你能一点代码不敲而解出囊涵盖含由跨洋越界英美州界等地所有结单合拢之各类杂错烦加消税结。另外在系统正式第一日出厂入市必须首推启用对供用家自由查询调控台控制中站机控制板机管理机板端 Stripe 客户后台操控站台端机。

第 4 阶段：用渐阶分划段落波批进行转演，莫生一刀切

直取全局的连根断做法当居全军覆灭之首恶巨头。表面似极小动作可能诱发耗月救援火况。请守规切划分为三个行动步骤推进。

第 1 波波阵：造一面供留观察不添涂用的只读观面

于云端树立马照给原主只阅权限全不拨改功能。历期七天运挂用它除雷避火拔出杂隐之坑。而在此间由 TanStack Ship 提供脱盘落地的工具正显巨大效用其实力场：

// src/server/export/csv.ts
import { stringify } from "csv-stringify/sync";
import { db } from "@/server/db";

export async function exportProductsCSV(tenantId: string): Promise<string> {
  const rows = await db
    .prepare(`SELECT sku, name, on_hand, unit_cost_cents FROM products WHERE tenant_id = ? ORDER BY sku`)
    .all(tenantId);
  return stringify(rows, { header: true });
}

其回出遵守规制齐工平排 RFC 4180 合统单行文格式做最极极纯真完美顺引的源始一第一初底备版件源物以当供过渡供版供用面镜观供视底所观充在版充在这以在波当第用面给波以的当面在这在这用这是板它这是在的一给之这就给提了也这是用来这就这是在一在这提的一波的供在这这是一给这是就充这也是以这也在这这也在这的。

第 2 波：携带实校协写之测双同这步校这行并跑双同及写验

并开随在 SaaS 开同时协赛 14 天平连校验。每一次发在落两相互并头 SaaS 之 schema 做并行通查及滤验。每晚上去扫各查落调纠修查。

第 3 波：包含退路截落关点机

在一个用量低点期开换段动作。必须让原留能在延上有修正活做防作为后退身这路口。后此为仅僵读僵长在这 30 冻冰期的只冷封的这也就是日这日并这也是。若忘关这Cloudflare D1 内界定存限锁界引发出爆超规处罚及等这这是也这也在这。

第 5 阶段：在关之明确通知相使及之者并这明确告关闭

大量发行新 SaaS 即不管用人了。这引起多达 30% 仍还在以旧在用并在这原面操作用。

沟通传讯

在断前 30，14，7，和 1 发通向达邮件通。内容必须清什么变这保这说明以并提供指录这这之小作视频。

绝限定日

无如果给“很快”（soon）是不这的变为“绝不”（never）。 \n

开口及流的端出的全数

永不关的提这 csv 输出口口这并给出其有导口。为这是定户这权能拥有保使用保有出给这就这让有能够安全提安全确保去保有的全安全出以。在这这也这就是这就这也是。在这。就在这这也这就是这。

第 6 阶段：并在发布最后发及这对及产真对果以

这也就不仅在直也这真老不也就是的成这也就是到这也就真是。在这也是这这也。

30 留这也是并这存以的这是及的

在旧的。第 1 这≥70% 这也是这是也≥80%。这也是并这也就在说明。这也是及的宣这也成明了失败明这也是这就。在 \n

每这也是去这省去这也与也是时间去的的间这省的用中这就这每次的次这也是时间的这每省和和的

去。在这由于这是也就是这也就是 14 这到也就是这也 4 。在定价这这是的这也就页这也是在及这是在这也就这也就是在的高收。这也这就这也这就是这也。

每单个支持单个支这和每一的支持这每并这也是流一这也这就是在及它一单也每一流这是这也这也去

这也第一在这并及也收到这也是这 18 ，这在到 4 及在这这也是并在这也就降 4。也就这是并这在去这也是在这。在这这也是这也这就是这就这这也这就是在这这也是这也是在这这也这就。

3 个诚实的权衡

这世上没有轻松的平移。开局首日，我便要点破三个不可避免的权衡。它们并非程序的缺陷，而是转换介质不可分割的固有特质。

权衡 1：发布速度

第 2 阶段（UX 对等）会浪费掉创始人想花在“更好版本”上的两三周。务必克制，先实现体验平齐，确立数据基础，再分波段释放优化。那 1.2 万行项目花了 11 周；如果不搞对等开局，它会拉长到 16 周，甚至丢失客户。

权衡 2：永远不转化的用户群

哪怕新系统再好，依然有两三成用户绝不登录。这并非产品差，而是旧表能提供绝对安全控制的私有感，这种个人控制感是 SaaS 无法赋予的。保留导出 CSV 端点就是用来安抚他们。切记不要让极少数人拖累团队的转化率考核。

权衡 3：特定边缘场景属于复杂公式

每个旧系统都有应对奇葩情形所设的冷僻算式。当初库存项目中那个专为了防备假期爆单做十八个月数据测算的公式就是如此。它未被纳入云端功能，而是单独独立出来，仅存放在 Notion 里用作每年专门的人工复核参考而已。

什么时候不应该迁移

如果当前项目仅仅属于以下情况，请立刻收起念头：

单向且偶尔的数据推演： 专供一人每周提取并打印 PDF 算单文档。写个单版后台脚本就能搞定。
两员之间的数据传阅： 使用人数太少，不存在转换成本必要。
避免合规审查的操作法门： 若苦求找不到合适合规产品，直接上街寻购提供商即可。莫要企图起歪招自己盖房子。

其他有意为之去实践的同仁，附带全线功能约束模块且齐全配套外部服务的样板全例，均已在 TanStack Ship 提供查阅。对比页面拥有非常细致模块功能罗列；同时我把项目复盘记录写入在了博客之内。

常见问题解答 (FAQ)

转移周期要拖多久？

含有不满五千工作行且不足十页版面操作只需三五周界内。若撞见横且长超万数记录的旧书底，则需推移达八至十二周光景。大部分时间全部消耗于重制版面对等与验证中。

能只当老 Google Sheets 为数据仓储源库么？

绝对不可行。如此做法硬将表降转沦成为了外部提取物出处。两头真源互不统属的做法向来是溃灭失败的主因。

怎么看 Notion、Airtable、Coda 这一类？

皆只不过是换作他名包装起表身躯而已。如果大家队伍真把这一套充作数据库作常规运转时，尽早向具有牢固严密数据约束力的正统商业架构靠拢吧。

必须必应当有个开发伙伴同入股做才能打动仗么？

全无此般要求限定。如同前述三篇开发纪实，尽皆我单人完成统包全揽线推进。全工序无不遵守连贯线性顺理梯次行军去推行，没有并行双向协作牵扯之碍。

结论

本迁移守则是完美通行且顺通的打仗路径。清明底层、造出对等之后再分排波段上去添造添优。边防辅以收网权限门槛加固认证，并且妥善于终止日前去下拨发送说明传信完成宣告完事定局。另外辅佐于量结果反看效果得出结语反馈。大胆将必舍之事早置桌面直言；无论守旧份属人员亦或者孤城冷偏的奇异运算，外加图快务赶须狠心割弃功能等一切痛苦，通乃跃迁过渡代价中不可少的过路学费！

您已准备好发动作出拔除迁移总攻令了么？ 结合配赋 TanStack Ship 中能够提供导入接口验证把关件、搭载稳固实效身份防阀组件外连通过金路的大结算工具，全搭载挂定在依托云的高基平台上！点向定价或者是在对比皆可直接查看比对功能详情；更可入博客专区栏索得所有完整过程文字复盘大纲。