如何在Crystal中为C库导出的Pointer(Void)类型添加扩展方法？

在Crystal里处理这种C导出的指针类型，确实有更优雅的方案，不用每次手动访问包装字段。这里有两种最常用的最佳实践，根据你的需求选就行：

方案一：直接扩展原类型（推荐，无额外包装） #

因为LibXXX::OldStruct本质是Pointer(Void)的别名，Crystal允许直接给这个类型添加扩展方法，完全不需要额外的包装结构体。这样你既能给它加自定义方法，又能直接用原C库的函数，非常透明：

lib LibXXX
  alias OldStruct = Pointer(Void)
  fun foo(old : OldStruct)
end

# 给OldStruct扩展自定义方法
extension LibXXX::OldStruct
  # 你的自定义方法
  def do_something
    puts "Doing something with the struct"
    # 内部可以直接调用原C库函数，self就是OldStruct实例
    LibXXX.foo(self)
  end

  # 甚至可以把原C库函数封装成实例方法，调用更顺手
  def foo
    LibXXX.foo(self)
  end
end

# 使用示例
# 假设你从C库拿到一个OldStruct实例
old = LibXXX.get_old_struct()
old.do_something()
old.foo() # 和直接调用LibXXX.foo(old)完全等价

方案二：包装结构体+隐式转换（需要额外状态时用） #

如果你需要给结构体附加额外的状态或数据，必须用包装结构体的话，可以通过实现to_unsafe方法让Crystal自动把你的新结构体转换成OldStruct类型，这样调用C库函数时就不用手动写.old了：

lib LibXXX
  alias OldStruct = Pointer(Void)
  fun foo(old : OldStruct)
end

struct NewStruct
  @old : LibXXX::OldStruct
  @extra_data : String # 比如你需要附加的额外数据

  def initialize(old : LibXXX::OldStruct, extra_data : String)
    @old = old
    @extra_data = extra_data
  end

  # 关键：实现这个方法，Crystal会自动把NewStruct转换成OldStruct
  def to_unsafe : LibXXX::OldStruct
    @old
  end

  # 自定义方法
  def log_and_foo
    puts "Extra data: #{@extra_data}"
    # 这里调用C库函数时，self会自动转成OldStruct
    LibXXX.foo(self)
  end
end

# 使用示例
old = LibXXX.get_old_struct()
new_struct = NewStruct.new(old, "some extra info")
# 直接传new_struct给C库函数，自动转换
LibXXX.foo(new_struct)
new_struct.log_and_foo()

为什么继承不行？ #

你遇到的编译错误是因为Crystal的结构体继承规则：只有抽象结构体才能被继承，而Pointer(Void)是具体的非抽象结构体，所以没法用继承的方式扩展它。这也是Crystal类型系统的设计限制，避免结构体继承带来的复杂性。

总结一下：如果不需要额外状态，优先用方案一，代码最简洁；如果需要封装额外数据，方案二的隐式转换能帮你实现透明调用，不用手动处理底层指针。

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