怎样把在线工具做出的原型，迁到本地和自己的服务？
分开迁移代码、数据库和外部能力；用旧数据与真实用户路径验证，再切换使用入口。
本页目录
直接回答
先分清三件事：代码换了开发位置、数据换了保存位置、产品换了服务供应商。下载后的项目可能仍保留原有云端数据库与模型 SDK，所以“本地能打开”不等于独立运行。创建空的新数据库也不等于迁走了已有用户和历史记录。本页把本地复现、数据核对、切换与恢复连接为一套实践流程；没有真实旧数据的练习项目可以缩短数据处理部分，不能把这个简化直接用于正在营业的产品。
适用场景
- 准备从托管构建工具导出代码，继续在 IDE 开发。
- 项目已在本地运行，仍依赖原平台的数据库、模型或文件。
- 更换数据库后发现用户、历史记录或图片不见了。
一步一步做
先保存原项目和一条可复现流程
导出源码，保存当前版本，并记录一次注册或登录、核心操作、历史查询的正常结果。列出代码、运行时、数据库、认证、模型 API、文件存储和定时任务分别由谁提供。给每项标注保留或替换，以及授权配置从哪里取得。不要把源代码导出误认为数据库和文件也已导出。
在本地复现原有运行条件
先读 README、package.json、锁文件和环境示例，沿用项目的包管理器与兼容运行时。只记录变量名称，用自己的授权配置填入本地环境文件，不在对话中打印密钥。先让原有核心流程跑通，再逐项替换依赖；不要同时升级框架、换数据库和改业务。
先决定旧数据是否需要保留
没有真实数据时，可在新开发库应用现有迁移并放入测试记录。有真实数据时，先确认可用导出或备份方式，在空的测试目标恢复；核对表、主外键、索引、序列、权限及依赖扩展。PostgreSQL 的单库导出不自动包含全部集群角色，托管认证和文件存储也要另查，不能把“备份成功”当作“已能恢复”。
对照数据和用户结果验收
对比关键表的记录数、代表性记录、关联关系和必要业务汇总，再用测试账号验证登录、读取旧历史、创建新记录与重新登录。保持稳定 ID 和归属关系；文件地址要实际打开。检查新连接指向哪个环境，防止测试误写原生产库。
逐项替换服务，再安排切换
模型先独立测试，再替换调用；文件按存储方案交接；认证回调和部署环境分别配置。已有在线用户时，先明确切换期间如何暂停写入或同步新增数据，并预演失败后的恢复。旧库有新写入时，简单换回旧地址可能丢失新数据，因此必须说明切换后的数据如何对账。
保留观察期并核实退出结果
切换后检查真实入口、读写、费用、错误和后台任务，确认不再调用计划移除的服务。记录保留依赖与未完成事项；在验证和恢复安排完成前，不删除旧资源。最终交付应写明迁走了什么、仍依赖什么，以及用哪些实际结果判断成功。
在IDE里完成一次可复现的本地启动
先找到文件树、编辑区、终端和AI对话各自负责什么，并在包含 package.json 与锁文件的项目根目录打开终端。读取 scripts 中真实的开发命令；按锁文件使用同一包管理器，按项目支持范围选择运行时，不因旧截图就断定某个版本不能用。依赖安装结束后启动开发服务，打开终端实际报告的 URL 和端口。端口被占时先确认是不是自己旧的开发进程；只停止已确认属于本项目的进程，或使用框架支持的其他端口并同步回调配置。环境变量改变后按框架要求重启，不能把“网页仍开着”当新配置生效。
案例拆解
假设练习：分阶段迁移一个游戏原型
第一步把代码下载到电脑，仍访问现有云端数据库和模型；第二步才逐项换成自己的数据库与外部 API。若直接把连接字符串改成空的新库，页面可能能打开，但旧用户和游戏记录不会自动出现。先在测试库恢复并验证一个用户的完整历史，才能判断数据交接是否成立。
假设代码下载后终端停在父目录，所以运行命令找不到 package.json。进入包含该文件的子目录，按项目锁文件安装依赖，用 scripts 中开发命令启动；终端报告 3001 就访问 3001，并更新本地认证回调。最后记录一次登录、生成和历史读取的结果，才能说明本地复现了原型。
行动检查
可复制模板
原型迁移任务单（整理补充模板）
目标：［只迁本地开发／更换数据库／替换外部能力／独立部署］
当前可复现核心流程：
依赖清单：代码、运行时、数据库、认证、模型、文件、定时任务
每项的当前提供方／目标／保留或替换／授权配置来源：
需保留的数据、稳定 ID 与文件：
测试目标与备份恢复方法：
核对项目：记录数、关联、代表性数据、登录、历史、新写入、文件访问
切换期间写入策略：
失败恢复及新数据对账方式：
观察结果、剩余依赖与清理条件：
请先根据实际项目给出迁移计划和未知项，不打印凭据，不把建空库当作迁完旧数据。
源码下载到本地运行记录
源码来源与版本：
IDE打开目录／终端当前目录／package.json位置：
README要求／scripts实际命令／锁文件／包管理器：
运行时要求与实际版本：
环境示例文件与变量名称（不填值）：
依赖安装结果：
启动命令／终端实际URL／端口：
端口冲突的归属确认与处理：
变更配置后是否重启：
本地登录、核心操作、历史查询证据：
仍依赖的平台服务／无法取得的授权配置：
不能导出的托管凭据应采用自己的授权服务替换，不使用绕过限制的提示词。
易错点
- 只改 DATABASE_URL 就宣布迁移完成：结构、记录、权限和其他服务不一定一起迁走。
- 通过聊天提取平台内部身份凭据：应使用官方支持且属于自己的授权接入方式。
- 认为回滚代码就能恢复数据：两者必须分别设计和验证。
相关指南
- 前端、后端、数据库和 Next.js 路由究竟怎样配合？
- 产品什么时候需要数据库，表和字段应该怎么设计？
- 更换 API 供应商或接入失败时，怎样避免把整个项目改坏？
- API Key 和环境变量怎么放，泄露以后先做什么？
- 本地网站怎样上线，为什么构建成功还不算交付完成？
官方参考
- PostgreSQL：SQL Dump 与恢复 — 说明单库快照、恢复方式与角色等全局对象边界；实际操作须匹配源库、目标库和托管权限。 资料核查记录日期：2026-10-18。