添加CarsonDB NuGet包后无法引用，编译报错CS0246

• 在PowerShell 7中创建空目录并进入
• 执行 dotnet new winforms 创建WinForms项目
• 执行 dotnet add package CarsonDB 安装NuGet包
• 在项目代码文件顶部添加 using CarsonDB;
• 执行 dotnet build 编译项目
• 出现编译错误：

  error CS0246: The type or namespace name 'CarsonDB' could not be found...

预期结果：项目能无错误编译

1. 确认NuGet包安装状态
   执行 dotnet list package 命令，查看项目已安装的包列表，确认CarsonDB是否存在。如果未找到，重新执行 dotnet add package CarsonDB，留意命令输出是否有“已成功添加包”的提示。

2. 验证命名空间正确性
   部分NuGet包的命名空间与包名不一致。可以查看项目依赖项中CarsonDB包的说明，或通过开发工具展开依赖项→NuGet→CarsonDB查看其包含的命名空间，确认实际需要引用的命名空间是否并非CarsonDB。

3. 清理重建项目
   依次执行以下命令清理缓存并重新还原依赖：

   dotnet clean
   dotnet restore
   dotnet build
   

4. 检查框架兼容性
   打开项目的.csproj文件，查看<TargetFramework>节点的内容（例如net6.0-windows），确认该框架版本是否在CarsonDB包支持范围内。如果版本不兼容，可调整项目框架版本，或指定兼容的CarsonDB版本安装：

   dotnet add package CarsonDB --version x.x.x
   

   （将x.x.x替换为实际兼容的版本号）

5. 手动确认项目文件引用
   打开.csproj文件，检查是否存在如下格式的节点：

   <PackageReference Include="CarsonDB" Version="x.x.x" />
   

   如果缺失，手动添加后执行dotnet restore。

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