C# 命名空间与类同名时引入using后仍需限定类名调用静态方法

这是C# 中命名空间与类型同名时的标识符解析优先级规则导致的，并非程序集引用缺失或编译故障。

具体解析逻辑梳理 #

1. 先明确你代码的层级结构：

   命名空间 BusinessLayer
   └── 子命名空间 LocalStorage（你通过using引入的目标）
       └── 类 LocalStorage（与上层子命名空间完全同名）
   

2. 当你在主项目编写using BusinessLayer.LocalStorage;时，除了将该命名空间下的所有类型导入当前作用域外，还会让编译器识别到：LocalStorage这个标识符首先对应BusinessLayer.LocalStorage这个命名空间本身（命名空间的名称本身就是可被直接解析的标识符）。
3. C# 编译器的名称解析优先级规定：无歧义的命名空间标识符优先级高于同名称的类型。因此你直接写LocalStorage时，编译器会优先将其解析为命名空间，而非那个同名的类：
   • 此时写LocalStorage.XXX()相当于试图从命名空间下直接查找静态方法XXX，自然无法匹配，触发编译错误。
   • 你写LocalStorage.LocalStorage.XXX()时，第一个LocalStorage被解析为命名空间，第二个LocalStorage才是该命名空间下的类，因此可以正常匹配到静态方法。

可选解决方案 #

• 方案1（最优）：修改命名或类名，从根源避免冲突
  遵循.NET通用命名规范，避免命名空间与类同名：
  • 可将类名改为LocalStorageService、LocalStorageManager这类带有职责后缀的名称
  • 也可将子命名空间改为BusinessLayer.LocalStorageCore等不与类重名的名称
• 方案2：使用using别名指定类引用
  在主项目的using区域新增类别名定义，强制将LocalStorage指向对应类：

  using LocalStorage = BusinessLayer.LocalStorage.LocalStorage;
  

  定义后即可直接调用LocalStorage.XXX()，不会再和命名空间标识符冲突。
• 方案3：保留全限定写法
  也就是你当前使用的LocalStorage.LocalStorage.XXX()写法，仅适合临时改动，长期维护可读性较差，不推荐。

注：该问题与Visual Studio版本、.NET Framework 4.6.1版本无关，所有C#版本遇到同类命名冲突都会触发该解析规则。

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