Unity C# 脚本学习笔记：命名空间与 using

写了几篇 C# 基础后，你可能发现很多 Unity 脚本开头都有类似这样的代码：

csharp 复制代码

using UnityEngine;
using System.Collections;

这两行到底是什么意思？为什么有了它们才能用 Debug.Log、MonoBehaviour 这些东西？这篇笔记就把命名空间（Namespace）和 using 的用法彻底讲清楚。

一、命名空间是干什么的？

想象一下，你在写一个大型项目，代码文件可能有几百个。如果所有人都在全局范围里定义类名，很容易重名。比如你定义了一个 Player 类，同事也定义了一个 Player 类，编译时就会冲突。命名空间就是用来解决这个问题的，它相当于给类加了一个"姓"，把类组织到不同的逻辑分组里。

类比一下：你叫"张三"，你同学也叫"张三"，但你们在不同班级，所以提到"张三"时需要说明是"一班张三"还是"二班张三"。命名空间就是那个"班级"，类名就是"张三"。用完整的"班级+姓名"就可以唯一确定一个人。

在 C# 里，类的全名是 命名空间.类名。比如 UnityEngine.Debug 和 System.Diagnostics.Debug 就是两个不同的 Debug 类，因为它们在各自的命名空间里，互不干扰。

二、定义命名空间

在 C# 中，用 namespace 关键字来声明命名空间。通常一个 .cs 文件里就定义一个命名空间，里面可以包含多个类、结构体、枚举等。

csharp 复制代码

namespace MyGame
{
    public class Player
    {
        public string name;
    }

    public class Enemy
    {
        public int health;
    }
}

这样，Player 类的全名就是 MyGame.Player，Enemy 的全名是 MyGame.Enemy。其他地方的代码如果不在 MyGame 命名空间内，要使用这些类就需要写全名，或者用 using 导入。

嵌套命名空间

命名空间可以嵌套，用点号分隔。

csharp 复制代码

namespace MyGame.Audio
{
    public class SoundManager { }
}

这相当于：

csharp 复制代码

namespace MyGame
{
    namespace Audio
    {
        public class SoundManager { }
    }
}

全名就是 MyGame.Audio.SoundManager。

三、using 指令的三种用法

using 关键字在 C# 中有多种用途，我们最常用的是导入命名空间。实际上它有三种用法：

1. 导入命名空间（最常用）

语法：using 命名空间;

它的作用是：在当前文件中，可以直接使用该命名空间里的类型，而不必写全名。

比如 Unity 脚本默认有：

csharp 复制代码

using UnityEngine;

如果没有这一行，我们要打印日志就得写：

csharp 复制代码

UnityEngine.Debug.Log("Hello");

有了 using UnityEngine; 之后，就可以简写成：

csharp 复制代码

Debug.Log("Hello");

每个 using 指令必须放在文件顶部，在命名空间或类声明之前。

2. using static：导入静态成员

using static 可以导入一个类的静态成员，这样直接使用静态方法或属性时就不用写类名了。

csharp 复制代码

using static UnityEngine.Mathf;

public class Test
{
    void Start()
    {
        float x = Abs(-5);      // 相当于 Mathf.Abs(-5)
        float y = Clamp(2.5f, 0f, 1f); // 相当于 Mathf.Clamp(2.5f, 0, 1)
    }
}

using static 在 C# 6.0 引入，导入的类必须是静态类，或者类中包含静态成员。使用后代码会简洁一些，但可读性可能下降，尤其是当不同类有同名静态方法时容易混淆，所以谨慎使用。

3. using 别名：给类型或命名空间起别名

当两个命名空间中有同名的类，或者类名太长时，可以用 using 给它们起别名。

语法：using 别名 = 命名空间或类型;

csharp 复制代码

using Debug2 = System.Diagnostics.Debug;
using UnityEngine;

public class Test
{
    void Start()
    {
        Debug.Log("Unity 的 Debug");
        Debug2.WriteLine("System 的 Debug");
    }
}

这里 Debug 是 UnityEngine.Debug（因为 using UnityEngine），Debug2 是 System.Diagnostics.Debug 的别名。通过别名就可以同时使用两个同名的类。

别名也可以指向命名空间：

csharp 复制代码

using Sys = System;

然后可以用 Sys.String 代替 System.String。

四、Unity 中常用的命名空间

写 Unity 脚本时，你会见到以下常见的命名空间：

UnityEngine：Unity 引擎的核心类型，如 MonoBehaviour、GameObject、Transform、Debug 等。几乎所有 Unity 脚本都要导入。
UnityEngine.UI：UGUI 的 UI 控件，如 Button、Text、Image。
UnityEngine.Events：UnityEvent 相关，用于 UI 事件。
UnityEngine.SceneManagement：场景管理，如 SceneManager.LoadScene。
System.Collections：非泛型集合接口（如 IEnumerator），协程需要它。
System.Collections.Generic：泛型集合，如 List<T>、Dictionary<TKey, TValue>。
System：基础类型和常用类，如 String、Math、Action、Func 等。

很多时候 Visual Studio 会自动添加一些常用的 using，但不是全部。如果代码中使用了某个类型但编译器报"找不到类型"，先检查是否缺少相应的 using，或者类型是否拼写错误。

五、命名空间的冲突与解决

当两个命名空间都有同名的类，且都被 using 导入时，直接使用类名就会产生歧义，编译报错。解决方案有：

使用全名指定。
使用别名（前面提到的 using 别名）。
只导入其中一个，另一个用全名。

例如：

csharp 复制代码

using UnityEngine;
using System;

public class Test
{
    void Start()
    {
        // 错误：Random 在两个命名空间都存在
        // Random r = new Random();

        // 方法一：全名
        UnityEngine.Random.Range(0, 10);
        System.Random rand = new System.Random();

        // 方法二：别名
        // 在文件顶部定义 using Rnd = System.Random;
    }
}

实际上 UnityEngine.Random 和 System.Random 都是常用的，所以很多人会在文件顶部添加别名：

csharp 复制代码

using Random = UnityEngine.Random;

这样代码里的 Random 就单指 Unity 的随机数了，如果要使用系统的随机数再写全名或另一个别名。

六、我的建议

每个脚本文件顶部按照"Unity 命名空间 → 系统命名空间 → 自定义命名空间"的顺序排列 using，会让代码更整洁。
不要滥用 using static，它虽然能让代码变短，但可能让阅读者不知道方法来源。
如果两个类经常重名，可以考虑用别名或者修改自己的命名空间设计，尽量避免全局冲突。
在开发自己的工具库或架构时，给自己的代码也套上命名空间，比如 namespace MyGame.Core，这样无论是自己维护还是团队协作都更清晰。

七、总结

命名空间是 C# 组织代码的重要方式，能避免类名冲突，让项目结构更清晰。using 指令让我们可以方便地导入命名空间，同时它也支持导入静态成员和定义别名。在 Unity 脚本里，我们经常与 UnityEngine、System.Collections 等命名空间打交道。