KB#0001：如何修复 Windows 系统中的"文件名过长"错误

当您在Windows系统中遇到"文件名过长"或"解压缩"错误时，这通常与Windows系统的最大文件路径限制有关。Windows系统对文件路径设有255个字符的长度限制。

解决方案一

尝试在Windows 10中启用长路径选项。

如果您遇到与Git相关的长路径错误，可以执行以下命令在Windows中启用长路径支持：

git config --system core.longpaths true

参考文档：https://github.com/msysgit/msysgit/wiki/Git-cannot-create-a-file-or-directory-with-a-long-path

解决方案二

在使用某些.NET MAUI构建工具时，您可能会遇到"DirectoryNotFoundException - 找不到路径的一部分"异常。这与某些32位.NET MAUI构建工具相关。要解决此问题，您可以尝试将解决方案放置在驱动器的根目录下，例如C:\Projects\。但请注意，此解决方案仅针对此特定异常，可能不适用于所有Windows长路径问题场景。

解决方案三

您可以通过在命令提示符中使用mklink命令创建符号链接来为路径定义别名。示例如下：

mklink /D C:\MyProject C:\my\long\path\to\solution\

您的解决方案(.sln)文件应位于C:\my\long\path\to\solution\目录中。请注意，如果您的.csproj文件中包含相对路径，此方法将无法正常工作！

此命令将在C盘根目录创建一个名为MyProject的符号链接，指向C:\my\long\path\to\solution\目录。之后您就可以通过C:\MyProject来访问C:\my\long\path\to\solution\目录中的内容。

注意：创建符号链接需要以管理员身份运行命令提示符。

然后您可以尝试使用dotnet build命令构建项目：

dotnet build C:\MyProject\MyProjectName.sln