简介
认识 AppPorts，以及这份文档的阅读方式与产品理念。
AppPorts 是一款免费、开源的 macOS 应用与数据迁移工具。它帮助你把占空间的应用、应用数据和自己的文件夹放到外部存储，并管理本地入口、接回和还原。你可以保留需要的内容，同时为 Mac 的内置存储腾出空间。
应用和数据可以分别迁移。例如，你可以只搬走一个大型应用，也可以把应用留在本机，只迁移它支持迁移的数据目录。不同内容有不同的限制，AppPorts 会根据所选项目提供相应操作。
这份文档怎么用
这份文档面向日常使用 AppPorts 的用户，帮助你完成准备、迁移、还原，以及遇到问题后的处理。
- 第一次使用：从快速开始完成安装和一次迁移。
- 已经知道要搬什么：直接看迁移应用或迁移数据。
- 想把内容搬回来或恢复入口：看还原、接回与解除链接。
- 想知道为什么这样设计：阅读“原理”；想了解实验过程与方案取舍，再看博客。
- 遇到陌生名词或异常提示：查名词解释、徽章与状态或常见问题与排查。
当前文档按 **AppPorts 2.0.0（build 50）**的界面和行为整理。正式版与开发版的区别见更新日志；使用较早版本时，请留意文中的版本说明。
还可以参考 DeepWiki 上的 AppPorts 文档进一步了解项目。AppPorts 的来源，见作者的博客文章。
想了解迁移方案是怎样形成的，可以阅读博客：从实验过程与失败结果中，了解 AppPorts 的取舍。
AppPorts 的产品哲学
| 原则 | 对使用意味着什么 |
|---|---|
| 透明体验 | 尽量保留熟悉的打开方式，让应用搬到外置盘后仍能从本地入口启动。 |
| 策略稳定 | 优先采用经过验证的方式；遇到无法确认的数据、权限或目标冲突时，先说明问题。 |
| 低系统负担 | 减少不必要的后台工作；挂载数据需要的登录和重连任务按实际状态运行。 |
| 广泛国际化 | 让更多语言的用户能够使用 AppPorts，并持续改善翻译。 |
| 无障碍友好 | 为界面操作、状态提示和辅助技术提供支持。 |
这些原则也意味着保留选择：只迁移应用的用户不必先研究容器数据；不满足挂载条件时，可以让数据继续留在本机。迁移后的内容仍依赖外置盘，重要数据也仍需要备份。
开始之前
先了解要搬的是应用本体还是应用数据，再确认外置盘和权限。AppPorts 不会把不支持的目录变成可迁移目录，也不能保证任意应用在任意存储设备上都能照常工作。