VS2022中.NET MAUI项目添加Razor组件库为Git子模块异常问题

你的操作存在配置失误，.NET MAUI完全支持将Razor组件库作为Git子模块引入，问题根源在于子模块的存放路径和Visual Studio的项目识别逻辑冲突，导致命名空间被错误继承。

一、修正子模块的存放路径 #

如果已经将子模块B放在了MAUI项目文件夹内，先移除并重新添加：

1. 移除现有错误子模块：

   git submodule deinit -f ./MAUIProjectFolder/SubmoduleB
   git rm -f ./MAUIProjectFolder/SubmoduleB
   

   手动删除.gitmodules文件中对应SubmoduleB的条目，保存后提交更改。
2. 重新添加子模块到解决方案根目录（而非MAUI项目文件夹内）：

   git submodule add https://your-repo-url/ComponentLibraryB.git ./ComponentLibraryB
   

3. 初始化嵌套子模块C：

   cd ComponentLibraryB
   git submodule update --init --recursive
   cd ..
   

二、正确配置项目引用 #

1. 在Visual Studio 2022中，右键解决方案 → 添加 → 现有项目，分别选择ComponentLibraryB.csproj和嵌套子模块C的.csproj文件，将它们加入解决方案。
2. 右键MAUI项目 → 添加 → 项目引用，勾选ComponentLibraryB，确认引用添加完成。
3. 检查子模块项目的命名空间配置：
   • 打开ComponentLibraryB.csproj，确保RootNamespace和AssemblyName是独立的（例如YourCompany.ComponentLibrary），不要依赖MAUI项目的命名空间：

     <RootNamespace>YourCompany.ComponentLibrary</RootNamespace>
     <AssemblyName>YourCompany.ComponentLibrary</AssemblyName>
     

三、修复Razor页面的命名空间引用 #

在MAUI的Razor页面中，直接使用子模块组件库的原始命名空间即可，无需带上MAUI项目的前缀：

@using YourCompany.ComponentLibrary.Components

<MyComponentFromSubModule />

关键注意事项 #

• 子模块必须放在解决方案根目录，若放在MAUI项目文件夹内，Visual Studio会将其识别为MAUI项目的嵌套文件夹，自动继承MAUI项目的命名空间前缀，破坏子模块的复用性。
• 确保Razor组件库的目标框架兼容MAUI：在ComponentLibraryB.csproj中添加MAUI支持的目标框架（如果需要）：

  <TargetFrameworks>net6.0;net6.0-android;net6.0-ios;net6.0-maccatalyst</TargetFrameworks>
  

• 嵌套子模块C的.NET 4.8类库需确保兼容.NET 6，可通过在其.csproj中添加<TargetFramework>net6.0</TargetFramework>（或多目标框架）来保证兼容性。

内容的提问来源于stack exchange，提问作者bobo