最近一直遇到一些怪事， iCloud常常該下載的不下載、該上傳的不上傳，常常畫面卡在這個檔案正在等待上傳或下載，弄了半天終於發現了以下的正確解法(不正確的：重開機、登出iCloud、取消同第後再重新同步，這些都沒用！浪費時間)：

☁️情況一 該下載的沒下載到， 這常常發生在有大型檔案，例如電子書、影片檔等等。第一步可以到系統偏好設定的iCloud裡把最佳化空間關掉，但這會產生一個後果，就是你的檔案很大的話，一下子就會把你的電腦空間吃光，所以我自己是還勾選，因此有的時候遇到一些檔案我想要讓他強制下載的話，可以用右鍵->立刻下載。但如果這樣子也搞不定的話，可以在終端機裡面用以下的指令：

首先第一步是先找出那些被上傳到雲端的檔案，iCloud會把那些羽化登仙的的檔案在本留一個同名的.icloud檔牌位，因此可以用：

find . -name ‘.*icloud’

這樣就會列出所有被上傳的檔。如果我們要強迫載下來，接著第二行的指令，用brctl這個指令去下載檔案：

find . -name ‘.icloud’ | perl -pe ’s|(.)/.(.*).icloud|$1/$2|s’ | while read file; do brctl download “$file”; done

☁️情況二 一直卡在上傳的狀態，常見的表現是進度條彷彿永遠跑不完．永遠顯示在上傳， 這樣的情形常常發生在有很多小檔案的修改上面，像我是在整理我的筆記，大概有幾千筆，整個資料夾就會產生卡住，明明就只是幾個mb的小檔案。解決方法就是單向同步整流，把所有跟上傳有關的程度跟暫存檔通通刪掉，先把bird停止運作：

killall bird

接著再把~Library/Application\ Support裡的CloudDocs這個檔案夾刪掉 ，你可以自己手動在Finder裡刪，也可以直接執行以下：

cd ~/Library/Application\ Support rm -rf CloudDocs

刪完後，會讓iCloud全部重新上傳一輪所有檔案，這可能會花一些時間跟吃一些網路流量，但至少可以重新運作了。最後補一點吐槽，蘋果大公司為什麼這麼不靠譜，人家Dropbox明明就完全沒問題。

另外，如果對上面的shellscript有興趣的話，可以到explainshell，貼上你的指令，會逐字解釋

# Claude 贊日

協霆分享的 iCloud 同步問題與解法，是許多 macOS 用戶的血淚經驗。iCloud 的設計初衷是「無縫同步」，但複雜的同步狀態機制往往會陷入死鎖——特別是面對大量小檔案或不穩定網路時。協霆提供的終端指令解法（brctl download、killall bird 與 CloudDocs 資料夾重置）堪稱「核武級清潔法」，直指問題根源而非表面症狀。

從系統工程的角度，協霆的排查邏輯可為他人示範：從簡單的 UI 操作（取消同步）進階到系統級干預（查詢同步檔案、強制下載），再到徹底重置（刪除同步狀態檔）。這也突顯了為什麼即使在 AI 時代，了解 Shell Script、系統檔案結構與進程管理仍是必備技能——當圖形界面失靈時，只有命令行能救你。對於醫療 IT 管理者，維護數百臺員工電腦的同步備份系統時，類似的自動化診斷與修復腳本將大幅提升效率。

延伸閱讀：

• macOS iCloud 同步機制與 CloudDocs 檔案結構
• explainshell.com 與 Shell Script 學習資源
• 企業檔案同步與備份的最佳實踐

原始 Facebook 貼文：連結