scrivener 2升级至scrivener 3需通过四种路径迁移：一、直接打开自动转换，保留结构但部分格式需手动校准；二、用“导入scrivener 2项目”功能重建文档树，适合复杂或损坏项目；三、导出为fountain/markdown再导入，确保内容无损但丢失快照与历史；四、手动同步偏好设置与模板，因配置文件不兼容。
如果您正在使用Scrivener 2并希望切换至Scrivener 3，您可能会遇到项目格式不兼容、自定义设置丢失或编译模板失效等问题。Scrivener 3采用全新底层架构与文件结构，旧版项目需经特定处理方可完整保留元数据、快照、样式和脚注行为。以下是完成迁移的多种可行路径：
一、直接打开并自动转换项目
Scrivener 3内置向后兼容机制，可识别Scrivener 2项目包并启动自动转换流程。该方式保留绝大多数内容结构，但部分高级格式（如特定RTF导出样式）可能需手动校准。
1、确保已安装Scrivener 3正式版（v3.0或更高版本）。
2、在Finder（macOS）或文件资源管理器（Windows）中定位Scrivener 2项目文件夹（通常以.scriv结尾，实际为包裹式文件夹）。
3、双击该项目，系统将提示“此项目由较早版本创建，是否升级？”选择是，升级并打开。
4、等待转换完成，Scrivener 3将生成新格式的项目副本，并在原位置保留原始.scriv文件夹作为备份。
二、使用“导入Scrivener 2项目”功能
该方法绕过自动转换引擎，通过中间解析层重建文档树，适用于含大量嵌套文件夹、外部链接或损坏元数据的复杂项目，可规避部分自动转换引发的样式错位问题。
1、启动Scrivener 3，点击菜单栏文件 → 导入 → Scrivener 2项目…。
2、浏览并选中目标.scriv文件夹，点击“打开”。
3、在弹出的导入设置窗口中，勾选保留快照与导入所有元数据字段选项。
4、指定新项目保存路径，点击“导入”。导入完成后，系统将重建全文索引与编译配置映射关系。
三、导出为Fountain/Markdown再重导入
当项目存在严重格式冲突（如混合使用Scrivener 2专属脚本格式与自定义CSS编译器）时，可借助中立文本格式作为迁移桥梁，确保纯内容无损，同时放弃不可移植的排版逻辑。
1、在Scrivener 2中打开待迁移项目，进入文件 → 编译…。
2、在编译格式中选择Fountain（.fountain）或MultiMarkdown（.md），取消勾选所有样式修饰选项。
3、执行编译，保存输出文件至本地磁盘。
4、在Scrivener 3中新建空白项目，点击文件 → 导入 → 文件…，选择刚导出的.fountain或.md文件。
5、导入后，手动重建文件夹结构与研究资料区内容，快照与修订历史将不可恢复。
四、逐项迁移偏好设置与模板
Scrivener 3不继承Scrivener 2的偏好设置文件（Preferences.scrivprefs），需手动同步关键配置，否则将丢失自定义键盘快捷键、编译预设、正则替换集及编辑器主题。
1、在Scrivener 2中，进入Scrivener → 偏好设置（macOS）或 工具 → 选项（Windows），截图记录“编译”、“编辑器”、“快捷键”三页中的全部自定义项。
2、在Scrivener 3中，依次打开对应设置面板：点击Scrivener → 设置 → 编译，逐项重建预设；在编辑器 → 样式中重新加载字体与行距；于键盘快捷键 → 自定义快捷键中复现操作映射。
3、将Scrivener 2中导出的模板（.scrivtemplate）文件复制到Scrivener 3模板目录：
macOS路径为~/Library/Application Support/Scrivener/Templates/
Windows路径为%APPDATA%\Literature\Scrivener\Templates\
