AppPorts：macOS 应用迁移工具

项目简介

AppPorts 是一款免费、开源的 macOS 应用，用 Swift / SwiftUI 编写。它把占空间的大型应用、应用数据和开发者工具目录迁移到外置存储，为 Mac 本地磁盘腾出空间。

迁移后，完整应用留在外置盘，本机保留一个轻量的 Stub Portal 入口：图标与原来一致，不带快捷方式箭头；外接盘连接时，仍可从 Finder、Dock 或系统应用启动器打开。具体采用哪种迁移方式，取决于应用类型、macOS 版本和存储条件。

除应用本身外，微信聊天记录、照片、视频、接收文件等适合的容器数据可以通过 APFS 挂载迁移处理，应用仍从原路径读取，原有签名保持不变；合适的普通数据目录、开发者工具目录和自定义文件夹则使用符号链接。

主要功能

• 无箭头迁移：把大型应用移到外置盘，本机保留轻量启动器；可并排查看本地与外置应用，迁移或还原时同步已有的 Dock 快捷方式。
• 更新保护：识别 Sparkle、Electron 等更新机制，对适合的应用提供「锁定迁移」以保护外置副本；更新前需解锁，网络卷不使用这些本地文件锁。
• 代码签名管理：检查签名状态，对「签名被替换」的应用给出修复步骤；保存完整的原应用备份，并在支持时还原原始签名，默认模式拒绝对沙盒应用重签名。
• 失效链接检测：标记不可用的目标，便于检查外接盘连接、定位丢失的应用或清理残留启动器。
• App Store 支持：在 macOS 15.1+ 上配合符合系统位置与格式要求的 App Store 应用进行原生外置安装与原地更新。
• 随时还原：连接原盘并确认本机空间足够后，可把应用或数据迁回；操作前检查运行中的应用与名称冲突，失败时尝试恢复并保留副本。
• 数据目录管理：以分组树浏览关联的应用数据，支持搜索、排序和隐藏零字节文件夹，也可管理 ~/.npm 等工具目录和自选文件夹。
• APFS 容器迁移：为适合的 Containers / Group Containers 在原路径挂载专用外置 APFS 卷，保留应用签名；迁移前检查是否为未加密 APFS、连接状态与可用空间。
• 就绪检查：检查完全磁盘访问权限、应用管理与外置存储状态，并显示当前运行副本的版本与路径。
• 现代界面与无障碍：原生 SwiftUI 界面，支持深色模式、目录展开动画、可调整信息面板、VoiceOver 标签与键盘快捷键。
• 多语言：支持 20 多种语言，包括简体中文、英文、日文、韩文、德文、法文、西班牙文等。

安装与使用

从官方发布的安装包下载 AppPorts 并放入「应用程序」文件夹后即可使用。首次运行建议先完成「就绪检查」，确认完全磁盘访问等权限与外接盘状态，再开始迁移。

如果官方下载的 AppPorts 首次启动提示「已损坏」，且确认来源可信，可移除隔离属性后再试：

xattr -rd com.apple.quarantine /Applications/AppPorts.app

迁移策略概览：

应用类型	策略
原生 Mac 应用	Stub Portal，完整应用置于外置库
自动更新应用（Sparkle、Electron 等）	Stub Portal，视检测结果加锁
iPhone / iPad 应用	iOS Stub Portal，macOS 15.1+ 自动可用
Mac App Store 应用	配合系统原生外置安装
应用套件（包含多个应用的文件夹）	文件夹镜像
容器数据（Containers / Group Containers）	APFS 挂载迁移
普通数据、工具目录、自定义文件夹	符号链接

系统应用、正在运行的应用和已建立链接的应用不会被迁移。

注意事项

• 当前 APFS 挂载迁移需要未加密的外置 APFS 存储；如果外接盘不满足要求，建议将容器数据保留在本机。
• 迁移后若有其他应用无法打开，请先检查外接盘连接、数据挂载状态与签名情况；由旧版重签名方式引起的问题可参考官方 macOS 27 升级与修复指南。
• 后台组件、权限和更新机制都会影响兼容性，具体限制请查看官方文档的兼容性说明。
• 从 2.1.0 起，存在未完成任务或旧副本残留时请继续在新版中处理：新版会保存新的迁移管理状态，旧版可能无法读取，不要把降级或删除任务历史当作恢复方法。
• 单个数据卷的手动卸载会持续保留暂停状态，需要恢复时请明确挂载或选择「恢复自动挂载」。
• 强制解绑会让原路径变成空目录，不会把旧数据搬回本机；要取回数据请使用迁回或还原流程。

---

本作品整理自 GitHub 开源项目 wzh4869/AppPorts，原作者 @wzh4869，许可证 Apache-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。