Scala类型层级打印实现问询：无需实例化Case Class

一、手动实现思路 #

要实现explainType[T]: String，核心是借助Scala的反射API解析类型的构造参数与嵌套结构，最终组装成JSON格式的描述字符串。

实现步骤与示例代码 #

利用scala.reflect.runtime.universe提供的反射能力，递归处理自定义类、标准库泛型类型（如Option、List）：

import scala.reflect.runtime.universe._

def explainType[T: TypeTag]: String = {
  // 递归解析单个类型
  def parseType(tpe: Type): String = tpe match {
    // 处理带泛型的类型（包括自定义类和标准库类）
    case TypeRef(_, sym, args) if sym.isClass =>
      val className = sym.name.toString
      if (args.isEmpty) {
        className
      } else if (sym.fullName.startsWith("scala.") || sym.fullName.startsWith("java.")) {
        // 标准库泛型类型，直接展示泛型参数
        s"${className}[${args.map(parseType).mkString(", ")}]"
      } else {
        // 自定义类，解析主构造器参数
        val constructor = sym.primaryConstructor.asMethod
        val paramDescriptions = constructor.paramLists.flatten.map { param =>
          s""""${param.name}": "${parseType(param.typeSignature)}""""
        }.mkString(", ")
        s"""{"$className": {$paramDescriptions}}"""
      }
    // 基础类型直接返回名称
    case other => other.toString
  }

  parseType(typeOf[T])
}

// 测试类定义
class AAA(i: Int, s: String, o: Option[Int], bbb: BBB)
class BBB(l: List[Int])

// 调用示例
// 输出：{"AAA": {"i": "Int", "s": "String", "o": "Option[Int]", "bbb": {"BBB": {"l": "List[Int]"}}}}
println(explainType[AAA])

二、现成工具库推荐 #

不需要手动实现的话，这些成熟库可以直接满足需求：

• Circe Schema：作为JSON序列化库Circe的扩展模块，能自动生成类型的JSON Schema，完整展示嵌套结构、泛型参数、可选性等信息，格式标准且可读性强。
• Magnolia：专注于自动派生类型类的库，可快速构建自定义的类型描述器，无需手写反射逻辑，代码更简洁且类型安全。
• Scala Meta：支持编译期解析类型结构，生成的类型描述更准确，适合对性能和编译期安全有要求的场景。

内容的提问来源于stack exchange，提问作者Дима Шестаев