Hammerspoon Lua代码转Fennel后，调用rotate方法报userdata类型错误

你混淆了Lua面向对象模型中两种方法调用的参数传递逻辑，这是跨语言移植Lua生态代码最常踩的坑。

Lua方法调用的两种本质差异 #

Lua没有原生的类系统，所有的“方法调用”本质都是普通函数调用，靠语法糖区分是否自动传递当前对象上下文：

• 冒号语法 screen:rotate(90) 是语法糖，等价于手动把对象作为第一个参数传入：screen.rotate(screen, 90)。这也是你原来的Lua代码能正常运行的原因——rotate方法是C层实现的实例函数，要求第一个参数必须是屏幕对象本身（也就是报错里说的userdata类型），冒号语法自动帮你把这个参数补上了。
• 点语法 screen.rotate 只是单纯从表/对象上取出对应的函数字段，不会自动传入任何上下文参数。

Fennel代码的错误根源 #

你写的 (monitor.rotate 90) 本质和点语法取函数是一样的：直接取出monitor上绑定的rotate函数，把90作为唯一的第一个参数传入。这时候rotate收到的第一个参数就是数字90，根本没有把屏幕对象本身传进去，完全匹配报错里的“传入rotate方法的第一个参数为number类型，不符合要求，预期类型为userdata”的描述。

你之前的疑惑“rotate方法本应只接收角度参数”其实是被Lua的冒号语法糖迷惑了：这个方法的实际C层签名永远是 rotate(调用对象, 旋转角度)，只是冒号语法把第一个参数藏起来了，看起来只需要传角度而已。

修正后的可用代码 #

Fennel专门提供了对应Lua冒号调用的语法，不需要手动传self参数：

;; 正确写法1：使用Fennel原生方法调用语法，等价于Lua的 monitor:rotate(90)
(fn rotate-vertical []
  (let [monitor (hs.screen.find "Dell")]
    (: monitor rotate 90)))

;; 正确写法2：手动显式传入self参数，和Lua点语法调用完全等价
(fn rotate-vertical []
  (let [monitor (hs.screen.find "Dell")]
    (monitor.rotate monitor 90)))

行号错位说明 #

你遇到的报错行号和实际config.fnl内容不匹配的问题，属于Fennel编译链路的调试映射bug——编译后的Lua代码没有正确把运行时错误位置和原Fennel源文件的行号对应起来，和你的业务代码逻辑无关。

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