如何理解“只有在 Lua 执行 Lua 函数时，当它跳回到代码中时，lua_Hook 才被调用（该事件仅发生一次）”？

我们可以查看源代码（Lua 5.4）：

int luaG_traceexec (lua_State *L, const Instruction *pc) {
  -- some parts removed
  if (mask & LUA_MASKLINE) {
    if (npci == 0 ||  /* 当进入新函数、*/
        pc <= L->oldpc ||  /* 当回到之前的位置（循环）或者*/
        changedline(p, pcRel(L->oldpc, p), npci)) {  /* 进入新的行数 */
      int newline = luaG_getfuncline(p, npci);
      luaD_hook(L, LUA_HOOKLINE, newline, 0, 0);  /* 调用行 hook */
    }
  }
  return 1;  /* 保持“陷阱” */
}

可以看到，LUA_HOOKLINE 在三种情况下被调用：(1) 进入新的函数，(2) 回到之前的位置（循环），或者 (3) 进入新的行数。

“进入新行数”是通过调用 changedline 进行检查的：

static int changedline (const Proto *p, int oldpc, int newpc) {
  while (oldpc++ < newpc) {
    if (p->lineinfo[oldpc] != 0)
      return (luaG_getfuncline(p, oldpc - 1) != luaG_getfuncline(p, newpc));
  }
  return 0;  /* 路上没有行数改变 */
}

如果新指令与上一条指令在不同行，则返回 true。

luaG_getfuncline 获取指令的行数（如果有可用的调试信息）。被检查的函数是基于当前调用信息值的活动 lua 函数。