technical

WSL2 开发与部署主路径

说明为什么 Toolplane 把 Ubuntu / WSL2 设为默认运行链路,以及现在的标准命令入口、staging 域名和 Windows fallback 规则。

Audience

开发者 / 部署维护

Updated

2026-03-24

Source

docs/wsl-delivery.zh-CN.md

当前标准

  • 默认构建、预览、部署、D1 迁移与 typegen 全部走 Ubuntu / WSL2
  • 当前 staging 域名是 toolplane.fluentreact.com
  • Windows 原生链路只保留给应急排查和对照验证

为什么现在切换

OpenNext 与 Cloudflare Workers 这条链路对 Linux 运行时更友好,WSL2 更接近最终线上环境。

之前已经出现过 Windows 原生上传成功但线上 Worker 全站 500 的情况,因此必须把 release proof 切到 WSL2 主路径。

当前命令入口

  • npm run dev
  • npm run build
  • npm run preview:staging
  • npm run deploy:staging
  • npm run d1:migrate:staging
  • npm run d1:seed:staging