常見問題與排查
從遇到的現象開始檢查，保留資料並找到下一步。
先儲存工作，記下 AppPorts 顯示的狀態和錯誤提示。涉及資料不可見或遷移中斷時，保留原盤與現有副本，再按下面的現象檢查。
應用打不開或開啟後立即退出
先確認原外接磁碟線上、本地入口沒有變成“孤立連結”。如果出現“簽名已替換”，或升級 macOS 27 後才發生問題，按升級與修復處理。沒有這類提示時，檢查原應用是否支援當前系統，並保留錯誤資訊；不能把所有啟動失敗都歸因於簽名。
應用能開啟，但原來的資料不見了
先退出應用，避免繼續向新建的空目錄寫入。開啟 AppPorts，確認對應資料為“已掛載”或連結正常，再檢查原應用是否獲准訪問可移動宗卷。外接磁碟上的檔案還在，並不等於原應用已接到這些檔案。若本地和外部都出現新內容，保留兩份，反饋具體路徑型別與狀態，勿直接互相覆蓋。
顯示“外接磁碟未連線”或“孤立連結”
重新連線原盤，在 Finder 或磁碟工具中檢查裝置是否出現，必要時解鎖，再重新整理 AppPorts。若卷線上但顯示“待掛載”，使用“掛載”。這些狀態可能只是暫時離線；確認原盤和目標位置後仍異常，再匯出診斷資訊。
掛載遷移的檢查沒有通過
先在“準備狀況”檢查權限、連線、格式和加密狀態；安裝位置與本次所需空間，以點選遷移後的檢查提示為準。當前容器掛載遷移要求APFS 儲存；其他內容不應一概套用這一要求。可以更換目標或保留本地資料，詳見外接磁碟準備。
遷移後某個應用說資料目錄不屬於我
這類提示來自應用自己的背景服務，例如 clash-verge 的系統服務拒絕啟動核心（錯誤碼 1012）。原因通常不是權限丟了，而是目標磁碟不保存檔案擁有者：exFAT、FAT32 沒有歸屬欄位，HFS+ 在以忽略擁有權的方式掛載時會把新檔案記成預留使用者。你的帳號看到的是自己，管理員服務看到的是那個預留值，於是判斷不一致。
提示裡常建議執行 sudo chown，但在這類卷上系統會靜默丟棄修改，指令看似成功、實際無效。可行的做法是：把這份資料還原到本機；或遷到 APFS 磁碟（APFS 保存真實歸屬）；HFS+ 可在 Finder 的「顯示簡介」中取消「忽略此磁碟區上的擁有權」後重新遷移。exFAT 沒有該開關。詳見外接磁碟是否記得檔案屬於誰。
提示目標已存在、保留副本或清理未完成
先核對本地與外部各自是什麼內容。“目標衝突”需要確認歸屬；“保留副本”或清理失敗則可能表示主體操作已完成，但收尾尚未結束。按介面提供的重試或保留選項處理，不要重複遷移、手工刪除備份或覆蓋同名目錄。恢復入口與搬回本地的區別見還原與接回。
遷移中斷後應該重來嗎
保持原儲存連線，先檢視 AppPorts 的恢復提示。中斷可能發生在複製、切換或清理階段，各階段留下的有效副本不同。保留程式提示的臨時目錄和備份；無法判斷時記錄最後一步和錯誤，不要自行選一份刪除。
哪些內容不適合遷移
系統應用、受保護的容器結構、整個使用者目錄，以及相互包含的受管目錄都有額外限制。虛擬機器、資料庫和正在下載的遊戲庫還可能有背景寫入，操作前必須完全停止使用它們。AppPorts 能識別一個目錄，不代表該應用支援把它搬到任意儲存。應用已有自己的儲存位置設定時，也可優先使用官方方式。
為什麼不允許移動某些容器目錄
有些目錄承擔系統結構作用，例如容器根目錄和特定臨時目錄。即使檔案複製和掛載都成功，應用也可能拒絕啟動。目錄列表中的保護提示需要保留，具體原因見容器結構實驗。
如何更新遷移後的應用
先檢視是否有“鎖定遷移”或“非鎖定遷移”提示。受保護的應用可能需要遷回、更新後再遷出；系統管理的 App Store 外接安裝有自己的更新流程。按應用更新說明處理，勿為了更新直接刪除外部副本。
為什麼磁碟工具裡多了 AppPorts 資料卷
這些可能是掛載遷移建立的專用卷。它們通常不會一直顯示在 Finder 邊欄，但仍存放實際資料。需要撤銷遷移時使用 AppPorts 的“還原”，不要在磁碟工具中直接抹掉或刪除這些卷。
外接磁碟上的 AppPorts Backups 能刪除嗎
這是手動重簽前儲存官方應用原包的資料夾，不是聊天記錄或文件備份。確認不再需要恢復材料、也沒有操作待完成時，可以在 Finder 中刪除對應原包；當前安裝和個人資料不受影響，但之後恢復官方狀態可能需要重新取得官方安裝包。AppPorts 也會自動清理已證明冗餘的原包，詳見儲存與清理規則。
恢復提示找不到原包時，先連線儲存它的那塊盤，確認資料夾仍在原位置。即使應用沒有遷出內建磁碟，新原包仍儲存在外接磁碟；沒有合適外接磁碟時，新的官方應用重簽會在修改正式應用前停止。
刪除 AppPorts 前要做什麼
先還原仍由它管理的容器資料，並確認完成清理。單獨刪除程式不會把資料搬回本機，還可能使自動接回失去所需程式。遷移過的應用和普通資料也建議先按還原說明檢查，明確它們目前存在哪裡。
AppPorts 會自動上傳我的檔案嗎
遷移操作在本機進行，日誌與診斷包也先儲存在本地。檢查更新、載入贊助名單等功能會訪問網路，因此不應把應用描述為完全離線。具體資訊和接收方見隱私政策。
怎樣反饋問題
在 GitHub Issues 描述 AppPorts 與 macOS 版本、外接磁碟格式、發生的操作、完整錯誤提示，以及問題是否可重複。透過選單欄“日誌 → 匯出診斷包”獲取記錄，提交前檢查是否含私人路徑或內容。診斷包不會自動上傳；不要公開聊天記錄、帳戶資料或無關檔案。
退出磁碟後不再自動掛載
從 AppPorts 主動退出會暫停整塊磁碟的自動掛載；即使 Finder 退出被取消，也需要拔下並重新插入裝置才能恢復。仍有卷宗掛載時先結束佔用應用，再「重試退出」，不要強行拔除。步驟見退出外接磁碟。
任務顯示暫停、正在取消或需要處理
暫停須等到可暫停的位置；正在取消須等安全收尾，均不應直接拔除磁碟。「加入背景」只是收起詳細資料，可以從工具列「任務中心」返回。需要處理時查看詳細資料的「處理異常」，保留提示中的副本，按異常恢復繼續。重新啟動後歷史任務不會自動重做遷移；背景清理結束也不等於原遷移成功。
啟動時提示正在遷移應用資料
關聯資料正在遷移、遷回或暫停複製時，更新後的原生啟動入口會提示等待。回到 AppPorts 查看任務並等待結束。此保護不能阻止直接開啟真實應用等其他方式，不要繞過提示強行啟動；範圍見啟動保護。