檔案路徑的長度限制是什麼？

Applies To

OneDrive for Windows

Windows、macOS、OneDrive、SharePoint 和 Office 的檔案路徑長度限制

不同的平台和應用程式支援不同的最大路徑長度，超過這些限制可能會防止檔案同步、開啟、移動或重新命名。

本文將說明什麼是檔案路徑、跨平台的路徑長度限制、可能遇到問題的位置、如何檢查路徑長度，以及保持在限制內的提示。

什麼是檔案路徑？

檔案路徑是電腦或雲端中檔案的完整位址。它包括階層中的每個資料夾和檔案名稱及其副檔名。路徑中的每個字元都會計入限制，包括 Windows 上的分隔符號 (反斜線、macOS) 上的正斜線、空格和副檔名。

Windows (檔案總管) -- 公司或學校帳戶
C:\Users\JaneDoe\OneDrive - Contoso\Projects\2026\Q1\Budget_Report_v3.xlsx

Windows (檔案總管) -- 個人帳戶
C:\Users\JaneDoe\OneDrive\Projects\2026\Q1\Budget_Report_v3.xlsx

在下列範例中，路徑開頭為磁碟機代號 (C:\) ，包含使用者設定檔資料夾、OneDrive 同步處理資料夾、巢狀資料夾結構以及檔案名稱。請注意，公司或學校帳戶路徑包括組織名稱，例如，OneDrive - Contoso () ，其使用的字元數會比 OneDrive) (個人帳戶資料夾還多。此差異表示擁有公司或學校帳戶的使用者，其檔案和資料夾名稱可用字元較少。

macOS (Finder)
/Users/janedoe/Library/CloudStorage/OneDrive - Contoso/Projects/2026/Q1/Budget_Report_v3.xlsx

在 macOS 上，路徑使用正斜線，通常從根目錄/目錄開始。

OneDrive 網頁版
Documents/Projects/2026/Q1/Budget_Report_v3.xlsx

在瀏覽器中，路徑會從 OneDrive 或 SharePoint 文件庫的根目錄開始。它不包括本機同步處理資料夾路徑，因此對於相同檔案，雲端路徑通常會比本機路徑短。

跨平台的路徑長度限制為何？

下表摘要說明每個平台的最大檔案路徑長度。在日常使用中遇到的最嚴格限制是 Windows 檔案總管和 Office 傳統型應用程式的 260 個字元。

平台	最大路徑長度	詳細資料
Windows Office 傳統型應用程式 (Word、PowerPoint、Excel)	256 個字元 (260 個 UTF16 WCHAR)	無法開啟完整路徑超過 260 個字元的檔案，即使檔案是儲存在本機也一樣。 Office 應用程式使用舊版 Win32 API 來強制執行 MAX`\`_PATH = 260 常數。
Windows 檔案系統 (預設)	260 個字元	預設情況下，Windows 檔案系統會強制執行 260 個字元的最大路徑長度。這是大部分 Windows 應用程式（包括檔案總管和 Office）所遵循的限制。
Windows 檔案總管	260 個字元	適用於開啟、重新命名和移動檔案。個別檔案或資料夾名稱最多可以有 255 個字元。即使已啟用 Windows 長路徑群組原則設定，檔案總管也不會使用它。
OneDrive 和 SharePoint (雲端儲存空間)	400 個字元	整個解碼的檔案路徑，包括檔案名稱，不能超過 400 個字元。
Office 網頁版 (Word、Excel、PowerPoint Online)	400 個字元	可以在瀏覽器中建立、重新命名和移動 Files 至此限制。
OneDrive 同步處理	520 個字元	總路徑是本機路徑的組合， (最多 400 個字元) 和 OneDrive 根資料夾 (最多 120 個字元) 。超過 520 個字元的路徑會顯示同步處理錯誤。
macOS Office 傳統型應用程式 (Word、PowerPoint & Excel)	1024 位元組 (1024 UTF8 編碼位元組)	路徑限制以 UTF-8 位元組而非字元為單位。含有多位元組字元的Files (例如重音符號、CJK) 可能會比預期更早達到限制。
macOS Finder	1,024 個字元	個別檔案或資料夾名稱限制為 255 個字元。在檔案系統層級，含有多位元組 Unicode 字元的路徑可能會超過 1,024 位元組，即使字元數似乎在限制之內。
Windows 檔案系統 (已啟用長路徑)	32,767 個字元	若要使用較長的路徑，您必須啟用 LongPathAware 群組原則設定。即便如此，每個應用程式也必須個別選擇加入以支援延伸長度路徑。檔案總管和 Office 傳統型應用程式目前並未選擇加入，因此僅啟用原則並不會變更大多數使用者的 260 個字元限制。
協力廠商應用程式	不定	協力廠商應用程式可能有自己的路徑長度限制，與作業系統無關。如果您在非 Microsoft 軟體中遇到路徑相關錯誤，請洽詢應用程式開發人員。

可能遇到路徑長度問題的地方

線上建立的無法在桌面上開啟的Files

您在 OneDrive 網頁版的深巢資料夾中建立 Office 檔案。雲端路徑在 400 個字元限制內。當檔案同步處理至您的電腦時，完整本機路徑會變長，因為您的 OneDrive 資料夾會新增字元 (例如 C:\Users\YourName\OneDrive - Your Organization Name\) 。如果總數超過 260 個字元，檔案將不會在 Office 傳統型應用程式中開啟，或在檔案總管中重新命名。

未出現在您電腦上的資料夾

您在 OneDrive 網頁版中建立名稱超過 255 個字元的資料夾。該資料夾在瀏覽器中運作，但它不會同步到 Windows 檔案總管或 macOS Finder，因為這兩個平台都將個別檔案和資料夾名稱限制為 255 個字元。

OneDrive 同步處理暫停並顯示「路徑太長」通知

如果同步處理檔案的完整路徑超過 520 個字元，OneDrive 會顯示「路徑太長」通知，而同步處理用戶端會結束，直到超限項目解決為止。

SharePoint 捷徑和同步處理的文件庫

當您為共用的 SharePoint 文件庫或 Teams 頻道資料夾新增 OneDrive 捷徑時，捷徑內容會同步處理到您裝置的 OneDrive 資料夾底下。如果共用文件庫具有深層巢狀或長資料夾名稱，那麼本機路徑很快就會超過 260 個字元，即使瀏覽器中的一切運作正常也是如此。

來自移轉的 Files

從其他雲端儲存服務移轉檔案時，合併的資料夾結構可能會意外超過路徑限制，特別是當原始結構具有深度巢狀結構時。

「無法完成動作」錯誤對話方塊

如果您看到錯誤對話方塊，顯示「無法完成此動作，因為其中的資料夾或檔案已在其他程式中開啟」，有時可能表示檔案路徑太長。儘管該訊息引用了另一個程序，但根本原因通常是路徑超過了平台的最大長度。請嘗試縮短檔案或資料夾名稱，或將檔案移至更接近根目錄磁碟機的位置。

Office 暫存檔案即使在 260 個字元以下也無法運作

Office 桌面應用程式會建立暫時鎖定檔案， (例如， ~$Budget_Report_v3.xlsx) 方法是在原始檔案路徑上附加字元。如果您的檔案路徑接近 260 個字元，這些衍生路徑可能會超過限制，並在儲存或開啟時造成錯誤。

如何檢查檔案路徑長度

在 Windows 上

開啟檔案總管並瀏覽至檔案。
選取網址列以顯示完整路徑。
複製路徑，將其貼到文字編輯器中，然後檢查字元數。

秘訣

您也可以以滑鼠右鍵按一下檔案，選取 [內容]，然後查看 [位置] 欄位。將檔案名稱長度新增至資料夾路徑長度，總計。

您也可以使用 PowerShell 檢查特定檔案的路徑長度：
("C:\Users\JaneDoe\OneDrive - Contoso\Projects\2026\Q1\Budget_Report_v3.xlsx").Length

或者，尋找目錄中路徑超過 260 個字元的所有檔案：
Get-ChildItem -Path "C:\Users\JaneDoe\OneDrive - Contoso" -Recurse | Where-Object { $_.FullName.Length -gt 260 } | Select-Object FullName, @{Name="PathLength";Expression={$_.FullName.Length}} | fl

macOS 版

以滑鼠右鍵按一下 (或按住 Control 鍵並) Finder 中的檔案，然後選取「 取得資訊」。
[ 位置 ] 欄位會顯示完整的資料夾路徑。新增檔案名稱長度的總計。您也可以使用終端機來檢查路徑長度：
echo -n "/Users/janedoe/Library/CloudStorage/OneDrive-Contoso/Projects/file.xlsx" | wc -c

在 OneDrive 網頁版上

在瀏覽器中瀏覽至檔案。
軌跡軌跡和 URL 會反映檔案路徑。請注意，特殊字元是 URL 編碼，並計入 400 個字元的限制。

注意

檔案和資料夾名稱中的特殊字元、空格和重音字元在 SharePoint 中會以 URL 編碼 (例如，空格會變成 %20) 。這些編碼表單會計入 400 個字元的限制，因此在瀏覽器中看起來簡短的路徑可能會使用比預期更多的字元。

在路徑長度限制內工作的祕訣

使用較短的檔案和資料夾名稱

較短的名稱可在路徑中留出更多資料夾深度的空間。例如：

「QBR 附註 - 2026 年 1 月」取代「季度業務審查會議記錄 - 2026 年 1 月」
「工程 & 科技」而非「工程及科技學系」

保持淺層資料夾結構

每個巢狀層級都會在路徑中新增字元。不要像專案 > 2026 年第 1 季用戶端工作 > Contoso > 交付項目>>最終核准這樣深度巢狀資料夾，而是考慮像專案 2026 > 年第 1 > 季Contoso > 最終交付項目這樣扁平的結構。>

讓共用文件庫的捷徑易於管理

新增共用 SharePoint 文件庫或 Teams 頻道資料夾的捷徑之前，請先檢查文件庫的資料夾結構巢狀結構深度。如果文件庫已有長路徑，請考慮只同步處理一個子資料夾，而不是整個文件庫，或要求文件庫擁有者將結構平面化。您也可以在新增捷徑之後，在 OneDrive 中重新命名捷徑，以使用較短的名稱。

需要時從網頁重新命名

如果檔案或資料夾的路徑太長而無法在檔案總管中使用的，請移至 OneDrive 網站或 SharePoint 網站，然後在那裡重新命名。一旦路徑足夠短，檔案就會正常同步到您的桌面。

將常用檔案放在更靠近根目錄的位置

儲存在靠近 OneDrive 資料夾頂端的 Files 具有較短的路徑。請考慮將您最常用的檔案保留在只有一或兩層深度的資料夾結構中。

請注意您的 OneDrive 根資料夾長度

例如，您的 OneDrive 同步處理資料夾路徑 (例如， C:\Users\YourName\OneDrive - Organization Name) 甚至在檔案路徑開頭之前就使用了字元。組織名稱越長，表示您的檔案和資料夾可使用的字元越少。 IT 系統管理員可以使用 OneDrive 資料夾群組原則的自訂名稱，來縮短其組織的這個資料夾名稱。