Unity测试脚本无法导入Runtime命名空间的原因与配置方案

问题原因 #

Unity的编译系统依赖**程序集定义（Assembly Definition）**管理代码的编译单元和引用关系。默认情况下，普通的Scripts和Tests目录不会被自动识别为独立的编译单元，测试脚本所在的程序集无法访问普通Scripts目录下的代码，因此会抛出CS0246找不到命名空间的编译错误。

而Scripts/Editor、Scripts/Runtime、Tests/Editor、Tests/Runtime是Unity官方约定的特殊源根目录，Unity会自动为这些目录生成对应的程序集定义，并自动建立测试程序集与运行时/编辑器程序集的引用关系，所以测试脚本能正常引用Scripts下的命名空间。

配置实现方法 #

方法一：使用Unity约定的目录结构（自动配置） #

• 调整现有目录结构：
  • 将业务逻辑代码迁移到Scripts/Runtime目录
  • 将编辑器工具类（如自定义Inspector、编辑器窗口）迁移到Scripts/Editor目录
  • 将运行时测试代码迁移到Tests/Runtime目录
  • 将编辑器测试代码迁移到Tests/Editor目录
• 完成迁移后，Unity会自动识别这些目录，生成对应的程序集并自动配置引用关系，测试脚本即可正常引用目标命名空间。

方法二：手动配置程序集定义（保留自定义目录） #

如果不想调整目录结构，可通过手动创建程序集定义实现：

1. 为Scripts目录创建程序集定义：
   • 在Scripts目录右键选择Create > Assembly Definition，命名为HMD-Scripts（名称可自定义）
   • 在Inspector面板中，确认程序集包含该目录下的所有代码，可按需设置命名空间前缀等参数
2. 为Tests目录创建测试程序集定义：
   • 在Tests目录右键选择Create > Assembly Definition，命名为HMD-Tests
   • 在Inspector面板中，勾选Test Assembly选项，标记为测试程序集
   • 在Assembly Definition References列表中，添加刚才创建的HMD-Scripts程序集，建立引用关系
3. 保存所有配置后，Unity会重新编译，测试脚本即可正常引用Scripts下的命名空间。

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