如何通过命令行重定向Visual Studio解决方案修复RN Windows构建问题

问题说明 #

构建React Native Windows项目时触发版本兼容错误：

Error : Microsoft.UI.Xaml nuget package requires TargetPlatformMinVersion >= 10.0.17763.0 (current project is 16299)

通过Visual Studio UI的重定向解决方案功能可修复该问题，此操作会自动更新项目配置及node_modules内相关文件。但为适配CI/CD流程尝试命令行执行时，运行以下命令出现路径解析错误：

msbuild windows\BopisPlus\BopisPlus.vcxproj /p:WindowsTargetPlatformVersion=10.0.17763.0

错误信息：

error MSB4184 The expression "[MSBuild]::GetDirectoryNameOfFileAbove('', node_modules\react-native-windows\package.json)" cannot be evaluated. The filename, directory name, or volume label syntax is incorrect. (Exception from HRESULT: 0x8007007B)

命令行修复方案 #

1. 使用Visual Studio开发者命令提示符 #

必须在Visual Studio对应的开发者命令提示符（如Developer Command Prompt for VS 2022）中执行命令，该环境已预配置MSBuild、Windows SDK的路径依赖，避免路径解析异常。

2. 针对解决方案文件执行完整命令 #

不要单独编译.vcxproj文件，而是针对项目解决方案（.sln）执行，同时指定最低版本和目标版本参数，并添加NuGet还原操作：

msbuild windows\BopisPlus.sln /p:WindowsTargetPlatformVersion=10.0.17763.0 /p:TargetPlatformMinVersion=10.0.17763.0 /t:Restore

/t:Restore参数会自动还原NuGet包并同步依赖配置，和VS UI重定向的行为完全匹配。

3. 确保在项目根目录执行 #

切换到React Native项目的根目录（即包含package.json的目录）后再运行命令，避免MSBuild解析相对路径时出错。

4. 备选：使用RNW CLI命令更新 #

直接调用react-native-windows的CLI工具完成版本同步，更贴合RNW的官方工作流：

npx react-native-windows upgrade --version latest --overwrite

该命令会自动更新项目的Windows SDK版本配置，并同步node_modules内的依赖文件，效果等同于VS的重定向操作。

内容的提问来源于stack exchange，提问作者V M ARAVIND