你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
了解 Azure NetApp 文件中的路径长度
文件和路径长度是指文件路径（包括目录）中的 Unicode 字符数。 此限制是单个字符长度的一个因素，这是由字符的大小（以字节为单位）决定的。 例如，NFS 和 SMB 允许的最大路径组成部分为 255 个字节。 American Standard Code for Information Interchange (ASCII) 的文件编码格式使用 8 位编码，这意味着 ASCII 中的文件路径组件（如文件或文件夹名称）最多可以包含 255 个字符，因为 ASCII 字符的大小为 1 字节。
下表显示了“Azure NetApp 文件”服务的卷中支持的组成部分和路径长度：
| 组件 | NFS | SMB |
|---|---|---|
| 路径组成部分大小 | 255 个字节 | 255 个字节 |
| 路径长度大小 | 无限制 | 默认：255 个字节 更高版本 Windows 中的最大值：32,767 个字节 |
| 横向路径的最大路径大小 | 4,096 个字节 | 255 个字节 |
注意
双协议卷使用最低的最大值。
如果 SMB 共享名为 \\SMB-SHARE，则该共享名会使路径长度增加 11 个 Unicode 字符，因为每个字符都是 1 个字节。 如果特定文件的路径为 \\SMB-SHARE\apps\archive\file，则为 29 个 Unicode 字符；每个字符（包括斜杠）为 1 个字节。 对于 NFS 装载，适用相同的概念。 装载路径 /AzureNetAppFiles 为 17 个 Unicode 字符，每个字符 1 个字节。
“Azure NetApp 文件”服务与新式 Windows 服务器支持的 SMB 共享支持相同的路径长度：最多 32,767 个字节。 但是，根据 Windows 客户端的版本，某些应用程序无法 支持超过 260 个字节的路径。 单个路径组成部分（斜杠之间的值，如文件名或文件夹名称）最多支持 255 个字节。 例如，在“Azure NetApp 文件”服务的文件路径中使用拉丁文大写字母“A”（每个字符占用 1 个字节）的文件名不能超过 255 个字符。
# mkdir 256charsaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa
mkdir: cannot create directory ‘256charsaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa’: File name too long
# mkdir 255charsaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa
# ls | grep 255
255charsaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa
识别字符大小
Linux 实用工具 uniutils 可以通过键入字符实例的多个实例并查看“bytes”字段来查找 Unicode 字符的字节大小。
示例 1：拉丁文大写字母 A 每次使用都会递增 1 个字节（使用单个十六进制值 41，在 0-255 的 ASCII 字符范围内）。
# printf %b 'AAA' | uniname
character byte UTF-32 encoded as glyph name
0 0 000041 41 A LATIN CAPITAL LETTER A
1 1 000041 41 A LATIN CAPITAL LETTER A
2 2 000041 41 A LATIN CAPITAL LETTER A
结果 1：名称 AAA 使用了 3 个字节（最多 255 个字节）。
示例 2：日语字符“字”每个实例会递增 3 个字节。 这也可以通过“encoded as”字段下的 3 个单独的十六进制代码值（E5、AD、97）来计算。 每个十六进制值表示 1 个字节：
# printf %b '字字字' | uniname
character byte UTF-32 encoded as glyph name
0 0 005B57 E5 AD 97 字 CJK character Nelson 1281
1 3 005B57 E5 AD 97 字 CJK character Nelson 1281
2 6 005B57 E5 AD 97 字 CJK character Nelson 1281
结果 2：命名为“字字字”的文件使用了 9 个字节（最多 255 个字节）。
示例 3：带有分音符的字母 Ä 每个实例使用 2 个字节 (C3 + 84)。
# printf %b 'ÄÄÄ' | uniname
character byte UTF-32 encoded as glyph name
0 0 0000C4 C3 84 Ä LATIN CAPITAL LETTER A WITH DIAERESIS
1 2 0000C4 C3 84 Ä LATIN CAPITAL LETTER A WITH DIAERESIS
2 4 0000C4 C3 84 Ä LATIN CAPITAL LETTER A WITH DIAERESIS
结果 3：命名为“ÄÄÄ”的文件使用了 6 个字节（最多 255 个字节）。
示例 4：特殊字符（如表情符号 😃）属于未定义的范围，不在 Unicode 字符使用的 0-3 个字节范围内。 因此，它使用代理项对进行字符编码。 在这种情况下，字符的每个实例使用 4 个字节。
# printf %b '😃😃😃' | uniname
character byte UTF-32 encoded as glyph name
0 0 01F603 F0 9F 98 83 😃 Character in undefined range
1 4 01F603 F0 9F 98 83 😃 Character in undefined range
2 8 01F603 F0 9F 98 83 😃 Character in undefined range
结果 4：命名为 😃😃😃 的文件使用了 255 个字节中的 12 个字节。
大多数表情符号都属于 4 字节范围，但最多可以达到 7 个字节。 在超过一千个标准表情符号中，大约有 180 个位于基本多语言平面 (BMP)中，这意味着它们可以在“Azure NetApp 文件”服务中显示为文本或表情符号（具体取决于客户端支持的语言类型）。
有关 BMP 和其他 Unicode 平面的详细信息，请参阅了解“Azure NetApp 文件”服务中的卷语言。
字符字节对路径长度的影响
尽管路径长度被认为是文件名或文件夹名称中的字符数，但它实际上是路径中支持的字节大小。 由于每个字符都会使名称的字节大小增大，因此不同语言的不同字符集支持不同的文件名长度。
请考虑下列情形：
文件或文件夹以重复的拉丁字母字符“A”作为名称。 （例如 AAAAAAAA）
由于“A”使用 1 个字节，而 255 个字节是路径组成部分的大小限制，因此允许在文件名中使用 255 个“A”实例。
文件或文件夹以重复的日语字符“字”作为名称。
由于“字”的大小为 3 个字节，因此文件名长度限制为 85 个“字”实例（3 字节 * 85 = 255 个字节），或总共 85 个字符。
文件或文件夹以重复的笑脸表情符号 (😃) 作为名称。
笑脸表情符号 (😃) 使用 4 个字节，这意味着仅包含表情符号的文件名将允许总共 64 个字符（255 个字节/4 个字节）。
- 文件或文件夹使用不同字符的组合（例如 Name字😃）。
如果文件名或文件夹名称中使用了不同字节大小的不同字符，则每个字符的字节大小都会影响文件或文件夹长度。 文件名或文件夹名称“Name字😃”将使用总共 255 个字节的长度中的 1+1+1+1+3+4 个字节（11 个字节）。
特殊表情符号概念
特殊表情符号（如标志表情符号）属于 BMP 分类：表情符号将呈现为文本或图像（具体取决于客户端支持情况）。 当客户端不支持图像指定时，它会改用基于区域文本的指定。
例如，美国标志使用字符“us”（类似于拉丁字符 U+S，但实际上是使用不同编码的特殊字符）。 Uniname 会显示字符之间的差异。
# printf %b 'US' | uniname
character byte UTF-32 encoded as glyph name
0 0 000055 55 U LATIN CAPITAL LETTER U
1 1 000053 53 S LATIN CAPITAL LETTER S
# printf %b '🇺🇸' | uniname
character byte UTF-32 encoded as glyph name
0 0 01F1FA F0 9F 87 BA 🇺 Character in undefined range
1 4 01F1F8 F0 9F 87 B8 🇸 Character in undefined range
为标志表情符号指定的字符在受支持的系统中将转换为标志图像，但在不受支持的系统中则会保留为文本值。 使用标志表情符号时，这些字符将每字符使用 4 个字节，总共 8 个字节。 因此，文件名中总共允许 31 个标志表情符号（255 个字节/8 个字节）。
SMB 路径限制
默认情况下，Windows 服务器和客户端支持高达 260 个字节的路径长度，但由于添加到 Windows 路径的元数据（如 <NUL> 值和域信息），实际文件路径长度会更短。
在 Windows 中，当超出路径限制时，将显示一个对话框：
使用 Windows 10/Windows Server 2016 版本 1607 或更高版本时，可以通过更改注册表值（如最大路径长度限制中所述）来扩展 SMB 路径长度。 更改此值后，路径长度可以扩展到最多 32,767 个字节（减去元数据值）。
启用此功能后，必须在路径中使用 \\?\ 来访问 SMB 共享，以允许更长的路径长度。 此方法不支持 UNC 路径，因此 SMB 共享需要映射到驱动器号。
改用 \\?\Z: 将允许访问并支持更长的文件路径。
注意
Windows CMD 目前不支持使用 \\?\。
无法增加最大路径长度时的解决方法
如果无法在 Windows 环境中启用最大路径长度或 Windows 客户端版本太低，有一种解决方法。 你可以将 SMB 共享更深入地装载到目录结构中，并减小查询的路径长度。
例如，请将 \\NAS-SHARE\AzureNetAppFiles\folder1\folder2\folder3\folder4 映射到 Z:，而不是将 \\NAS-SHARE\AzureNetAppFiles 映射到 Z:。
NFS 路径限制
“Azure NetApp 文件”服务卷的 NFS 路径限制对单个路径组成部分同样具有 255 个字节的限制。 但是，每个组成部分一次评估一个，每个请求最多可以处理 4,096 个字节，总路径长度几乎是无限的。 例如，如果每个路径组成部分为 255 个字节，则 NFS 客户端可以每个请求最多评估 15 个组成部分（包括 / 字符）。 因此，对超过 4,096 个字节限制的路径发出的 cd 请求会导致“文件名太长”错误消息。
在大多数情况下，Unicode 字符为 1 个字节或更少，因此 4,096 个字节的限制对应于 4,096 个字符。 如果字符的大小大于 1 个字节，则路径长度小于 4,096 个字符。 与单字节字符相比，大小大于 1 个字节的字符将会在总字符计数中产生更高的计数。
可以使用 getconf PATH_MAX /NFSmountpoint 命令查询路径长度最大值。
注意
该限制在 NFS 客户端的 limits.h 文件中定义。 请勿调整这些限制。
双协议卷注意事项
使用 Azure NetApp 文件进行双重协议访问时，NFS 和 SMB 协议中路径长度处理方式的差异可能会导致文件和文件夹之间的不兼容。 例如，Windows SMB 在路径中最多支持 32,767 个字符（前提是在 SMB 客户端上启用了长路径功能），但 NFS 支持可能会超过该数量。 因此，如果在 NFS 中创建了超过 SMB 支持范围的路径长度，那么一旦达到最大路径长度，客户端将无法访问数据。 在这些情况下，请在创建文件名和文件夹名称（以及文件夹路径深度）时，考虑不同协议的文件路径长度限制（使用较小的限制值），或者将 SMB 共享映射到更接近所需文件夹路径的位置以减小路径长度。
请考虑将 SMB 共享映射到整个路径 \\share\folder1\folder2\folder3\folder4，而不是将 SMB 共享映射到卷的顶层以导航到路径 \\share\folder1\folder2\folder3\folder4。 因此，映射到 Z: 的驱动器号将会进入所需文件夹中，将路径长度从 Z:\folder1\folder2\folder3\folder4\file 缩短为 Z:\file。
特殊字符注意事项
“Azure NetApp 文件”服务卷使用语言类型 C.UTF-8，其中涵盖了许多国家/地区和语言，包括德语、西里尔文、希伯来语和大多数中文/日语/朝鲜语 (CJK)。 Unicode 中的最常见文本字符为 3 个字节或更少。 特殊字符（如表情符号、音乐符号和数学符号）通常大于 3 个字节。 有些使用 UTF-16 代理项对逻辑。
如果使用了“Azure NetApp 文件”服务不支持的字符，可能会看到要求请求其他文件名的警告。
该错误实际上是因字符字节大小过大导致“Azure NetApp 文件”服务卷无法通过 SMB 使用而导致的，而不是由于名称过长。 “Azure NetApp 文件”服务中没有针对此限制的解决方法。 有关“Azure NetApp 文件”服务中的特殊字符处理的详细信息，请参阅有关特殊字符集的协议行为。