在 Windows NT 中資源管理器和諸多傳統(tǒng)的 Windows API 都對(duì)路徑長(zhǎng)度有限制，這個(gè)限制是 260 個(gè)字符 (包括盤(pán)符、冒號(hào)、反斜杠和文件名等等)，如果文件的整個(gè)路徑超過(guò) 260 個(gè)字符則在訪問(wèn)、復(fù)制、刪除時(shí)都會(huì)提示路徑太長(zhǎng)或文件名太長(zhǎng)的錯(cuò)誤。

這種限制屬于歷史遺留問(wèn)題，最初微軟設(shè)置這個(gè)限制主要是用來(lái)兼容舊版文件系統(tǒng)例如 FAT 以及兼容早期的 Windows API，但在現(xiàn)代開(kāi)發(fā)設(shè)計(jì)中文件夾層級(jí)非常深的情況也非常常見(jiàn)，例如 Node.js 項(xiàng)目中的 mode_modules 文件夾層級(jí)就非常多。

在 Windows 系統(tǒng)中，「路徑長(zhǎng)度限制」一直是個(gè)讓人頭疼的老大難問(wèn)題。出于歷史兼容性考量，Win32 API 默認(rèn)把「完整路徑」限制在 260 個(gè)字符以內(nèi)，這個(gè)長(zhǎng)度由常量MAX_PATH來(lái)定義。

為了解決這個(gè)問(wèn)題，并提升兼容性。從 Windows 10 1607 開(kāi)始，微軟在 Win32 API 中引入了「長(zhǎng)路徑支持」功能。啟用后，用戶和應(yīng)用程序就可以使用最長(zhǎng)約 32767 個(gè)字符的路徑，大大提升了復(fù)雜文件目錄結(jié)構(gòu)的兼容性。

接下來(lái)，我們就來(lái)看看在 Windows 11 中，如何為所有用戶開(kāi)啟或關(guān)閉 Win32 長(zhǎng)路徑支持。

Windows 11 文件名和路徑長(zhǎng)度限制

1、微軟官方文檔怎么說(shuō)

• 文件名長(zhǎng)度限制：在 NTFS 或 exFAT 文件系統(tǒng)上，單個(gè)文件或文件夾名稱（包括擴(kuò)展名）的長(zhǎng)度通常不超過(guò) 255 個(gè)字符。
• 完整路徑長(zhǎng)度限制：默認(rèn)情況下，包括 Windows 11 在內(nèi)，仍然遵循 MAX_PATH = 260 個(gè)字符的限制。所謂「完整路徑」，就是指包括：盤(pán)符、冒號(hào)、反斜杠、所有目錄與文件名，以及<NUL>終止空字符的總長(zhǎng)度。例如：

D:\主文件夾\我是一個(gè)子文件夾\我是一個(gè)孫子文件夾\我是一個(gè)重孫子文件夾\demo.txt

讓我們來(lái)快速對(duì)比一下：

2、超出限制會(huì)怎么樣

微軟文檔只是理論值，實(shí)際測(cè)試結(jié)果可能有些玄幻，大致會(huì)出現(xiàn)以下幾種情況：

• 如果單個(gè)文件或文件夾名稱超過(guò)限制，Windows 11 會(huì)自動(dòng)截?cái)嗟阶畲箝L(zhǎng)度。
• 在文件夾嵌套時(shí)，如果「完整路徑」超過(guò)上限，系統(tǒng)會(huì)直接拒絕創(chuàng)建。
• 對(duì)于不同的文件類(lèi)型，表現(xiàn)還不太相同。例如，在文件夾中新建超過(guò)（路徑）長(zhǎng)度限制的.txt文件時(shí)，名稱可能會(huì)被截?cái)?，而不是直接?bào)錯(cuò)。

指定的文件名無(wú)效或太長(zhǎng)

目標(biāo)路徑太長(zhǎng)

啟用 Win32 長(zhǎng)路徑支持

啟用長(zhǎng)路徑支持后，就能打破MAX_PATH限制，讓常用的 Win32 文件和目錄操作函數(shù)處理超過(guò) 260 個(gè)字符的路徑。以后再遇到「套娃」式文件夾，也不用再擔(dān)心操作失敗。

1、通過(guò)「設(shè)置」

僅適用于 Windows 11 25H2 及以高版本。

1、按Windows + I快捷鍵打開(kāi)「設(shè)置」，進(jìn)入「系統(tǒng)」>「高級(jí)」。

2、在「文件資源管理器」區(qū)域中，打開(kāi)「啟用長(zhǎng)路徑」開(kāi)關(guān)。

打開(kāi)「啟用長(zhǎng)路徑 」開(kāi)關(guān)

2、通過(guò)組策略

如果你使用的是 Windows 10 1607 及以上版本的專業(yè)版、教育版或企業(yè)版，可以更改組策略實(shí)現(xiàn)：

1、按Windows + R快捷鍵打開(kāi)「運(yùn)行」對(duì)話框，輸入gpedit.msc并回車(chē)，打開(kāi)「本地組策略編輯器」。

2、依次展開(kāi)「計(jì)算機(jī)配置」>「管理模板」>「系統(tǒng)」>「文件系統(tǒng)」。

3、將「啟用 Win32 長(zhǎng)路徑」策略，設(shè)置為「已啟用」。

4、重啟電腦讓設(shè)置生效。

打開(kāi)「啟用 Win32 長(zhǎng)路徑」組策略

3、通過(guò)注冊(cè)表

1、按Windows + R打開(kāi)「運(yùn)行」對(duì)話框，輸入regedit并回車(chē)，打開(kāi)注冊(cè)表編輯器。

2、導(dǎo)航到以下位置：

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem

3、找到名為LongPathsEnabled的 DWORD (32 位) 值（沒(méi)有就新建），并將其十六進(jìn)制值設(shè)置為：

• 1：開(kāi)啟 Win32 長(zhǎng)路徑支持（對(duì)所有用戶生效）
• 0：關(guān)閉 Win32 長(zhǎng)路徑功能

4、重啟電腦讓設(shè)置生效。

指定 LongPathsEnabled 注冊(cè)表值

注意事項(xiàng)

開(kāi)啟 Win32 長(zhǎng)路徑支持后，并不意味著所有軟件都能自動(dòng)適配。只有在應(yīng)用程序的程序清單（Application Manifest）中聲明了longPathAware元素，明確表明支持長(zhǎng)路徑的應(yīng)用，才能真正突破原有限制，充分利用這一特性。