构建项目触发路径过长错误，移动文件会影响依赖吗？
2026-8-18
MSB4248路径过长错误的解决方法
错误详情
| 严重性 | 错误代码 | 描述 | 项目 | 文件 | 行号 | 抑制状态 |
|---|---|---|---|---|---|---|
| 错误 | MSB4248 | 无法在表达式$([MSBuild]::ValueOrDefault('%(FullPath)', '').StartsWith($([MSBuild]::EnsureTrailingSlash($(MSBuildProjectDirectory)))))中扩展元数据。项元数据%(FullPath)无法应用于路径wwwroot\react-chp\node_modules\babel-preset-react-app\node_modules%40babel\preset-env\node_modules%40babel\plugin-proposal-numeric-separator\node_modules%40babel\core\node_modules.bin\parser。路径：C:\Users\Jabari.LAPTOP-FERO3UB5\Desktop\Work\codebase\CHP\Presentation\Chp.Web\wwwroot\react-chp\node_modules\babel-preset-react-app\node_modules@babel\preset-env\node_modules@babel\plugin-proposal-numeric-separator\node_modules@babel\core\node_modules.bin\parser 超出了操作系统的最大路径限制。完全限定文件名必须少于260个字符。 | C:\Users\Jabari.LAPTOP-FERO3UB5\Desktop\Work\codebase\CHP\Presentation\Chp.Web\Chp.Web.csproj | C:\Program Files\dotnet\sdk\6.0.400\Sdks\Microsoft.NET.Sdk\targets\Microsoft.NET.Sdk.DefaultItems.targets | 100 |
核心原因
Windows默认限制文件路径长度不超过260字符，项目中node_modules依赖嵌套层级过深，导致路径超限触发MSBuild错误。
解决步骤
- 缩短项目根路径：将整个项目迁移到路径更短的目录，比如从
C:\Users\Jabari.LAPTOP-FERO3UB5\Desktop\Work\codebase\CHP\Presentation\Chp.Web移至C:\Projects\Chp.Web，直接减少基础路径长度。 - 启用Windows长路径支持：
- 运行
regedit打开注册表编辑器 - 定位到
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem - 将
LongPathsEnabled的值修改为1（无此项则新建DWORD(32位)值） - 重启电脑生效
- 运行
- 优化Node.js依赖结构：
- 使用npm v7+执行
npm install，默认会自动扁平化依赖 - 手动执行
npm dedupe减少依赖嵌套层级 - 升级
babel-preset-react-app至最新版本，优化依赖树
- 使用npm v7+执行
- 调整MSBuild配置排除冗余文件：在
Chp.Web.csproj中添加以下配置，让MSBuild忽略node_modules中不必要的文件：
<ItemGroup> <Content Remove="wwwroot\react-chp\node_modules\**" /> <None Include="wwwroot\react-chp\node_modules\**" Exclude="**\*.js;**\*.json" /> </ItemGroup>
- 用符号链接简化路径：将
node_modules移到短路径目录，再在项目目录创建符号链接：
mklink /D C:\ShortPath\node_modules C:\YourOriginalPath\wwwroot\react-chp\node_modules
需以管理员权限执行命令。
内容的提问来源于stack exchange，提问作者IndianaCones88
相关产品推荐
相关产品推荐
