Lua中Aseprite API的Image对象为何不是表？如何获取其全部属性与方法

你之前对Lua对象的理解，只覆盖了纯Lua层模拟的面向对象逻辑：也就是完全用Lua表实现、没有绑定原生代码的对象，这类东西本质就是table，确实可以用pairs遍历所有键值对。
但Aseprite里的ImageObj根本不是普通表：

• 它属于C/C++绑定的用户自定义类型（userdata），是Aseprite用原生代码封装、注册到内置Lua解释器里的类型，内存结构和Lua自带的table完全不同
• pairs()的原生逻辑只认Lua table类型，碰到userdata就会直接抛出table expected, got ImageObj的错误，根本不会去解析对象内部的内容
• 哪怕你强制访问它的元表，也不会像纯Lua写的类那样，把所有属性、方法存在一个可以枚举的表结构里。

它是Aseprite通过Lua C API注册的原生绑定类型：

• 所有对Image对象的属性读写、方法调用，本质都是触发绑定好的C函数，直接操作Aseprite内部的图像内存数据，从来没有把属性存在Lua层面的表里
• 它身上挂的元表只实现了两个核心交互逻辑：
  • 当你写image.width = 100这类代码时，元表的__newindex元方法会跳转到对应的原生赋值逻辑
  • 当你写image:isEqual(otherImage)这类代码时，元表的__index元方法会返回绑定好的原生函数
• 这个元表没有实现遍历相关的逻辑，也不会把所有可用的属性、方法名暴露成可枚举的键值对，所以靠pairs是绝对拿不到内容的。

实际查询可以用这三个方法：

• 优先看Aseprite内置的离线API文档：打开Aseprite的脚本编辑器，把光标定位到Image类名上按F1，就能直接弹出对应的类说明，里面列全了所有支持的属性、方法、参数规则，完全不需要跳转外部网站。
• 手动遍历元表拆解可用方法：写一段临时脚本，把和Image对象关联的元表里挂的方法全部弹出来：

  -- 传入任意一个已有的image对象做样本
  local sampleImage = app.activeSprite.image
  -- 获取对象绑定的元表
  local objMt = getmetatable(sampleImage)
  -- 普通方法一般都挂在元表的__index字段上
  for methodName, methodFunc in pairs(objMt.__index) do
    app.alert("可用方法: " .. methodName)
  end
  

  注意：这个方法只能列出来普通的方法名，像width、height、color这类带内置读写器的属性，是直接绑定在元方法里的，不会被遍历到，必须靠文档查询。
• 利用Aseprite的报错提示：如果你尝试访问了对象上不存在的属性，Aseprite抛出的报错信息一般会附上这个对象支持的属性列表，可以顺着提示补全代码。

另外提一句，你之前写的循环代码还有个变量名不匹配的问题：循环里定义的变量是attribute和value，但alert里用了未定义的k和v，就算pairs不报错，跑起来也会抛变量不存在的错误。

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