调用System.Data.SqlClient报datatable could not be found错误

报错场景截图

按优先级从高到低逐一验证即可：

• 先确认项目类型匹配正确的引用方式
  • 若你用的是传统 .NET Framework 项目：右键项目「引用」→「添加引用」，在框架程序集列表中同时勾选System.Data和System.Data.SqlClient两个程序集，仅添加System.Data不会自动带入SqlClient相关依赖，不少老教程默认项目模板自带这两个引用，新版本VS新建项目不会默认加载，很容易漏加。
  • 若你用的是 .NET Core/.NET 5+ 跨平台项目：不要手动添加框架自带的System.Data引用，直接打开NuGet包管理器，搜索安装稳定版System.Data.SqlClient包即可，这类项目里System.Data和SqlClient都是独立分发的NuGet包，手动加框架引用无效。
• 检查代码文件的命名空间导入
  哪怕引用添加正确，没有在代码文件顶部写入以下using语句，编译器同样无法识别DataTable类型：

  using System.Data;
  using System.Data.SqlClient;
  

• 排查依赖版本冲突
  打开NuGet已安装包列表，检查是否有其他依赖项引入了不同版本的System.Data.SqlClient，把所有相关包统一更新到同一稳定版本；如果是SDK风格项目，可以直接打开.csproj项目文件，删除手动写的错误版本的System.Data引用行，重新通过NuGet安装对应包即可。
• 最小场景验证排除项目配置干扰
  新建一个空控制台项目，仅安装System.Data.SqlClient包、导入对应命名空间，写入测试代码DataTable dt = new DataTable();后编译：
  • 如果空项目编译通过：回到原项目，删除根目录下的bin、obj缓存文件夹，点击「重新生成解决方案」即可解决残留配置导致的加载失败。
  • 如果空项目也报相同错误：说明本地.NET SDK安装损坏，重装对应版本的SDK即可恢复。

补充说明：目前微软已将SqlClient的后续维护迁移到Microsoft.Data.SqlClient新包，老的System.Data.SqlClient已停止功能更新，新项目建议直接迁移使用新包，老项目按上述步骤排查即可解决报错。

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