Lua报错：尝试索引全局变量'square'（nil值），求排查方案

阿华AIGC实验室

2026-5-29

搞定「attempt to index global 'square' (a nil value)」错误的思路

嘿，我帮你捋捋这个问题哈——你遇到的这个错误其实就是Lua在告诉你：“你让我找一个叫square的全局变量，但我根本找不到它啊！”

先看你标记的错误代码行：

if square.y > display.contentHeight then square.y = 0 -- This is the error end

这里的square是当成全局变量来用的，但你看你写的代码里，所有创建square的地方都是用local square = ...声明的局部变量——这些变量只在它们所在的tap点击函数内部（包括里面嵌套的moveSquare函数）有效，出了那个函数就“消失”了。如果这行错误代码是在比如你后面写的movePlayer函数里，那这里的square完全没被定义，Lua自然会报nil错误。

另外我还发现你代码里有几个容易踩的坑：

你写了4个同名的movePlayer函数，后面的会直接覆盖前面的，结果就是只有最后一个移动逻辑生效，前面的左右上下移动全白写了
每次点击按钮都会创建新的square和新的enterFrame监听器，但从来没清理过，玩久了游戏会越来越卡，甚至崩溃

具体修复方案

1. 先搞定最直接的错误

如果这行错误代码是你不小心把player写成了square（比如在玩家移动的逻辑里），那直接改回player就行：

-- 错误写法
if square.y > display.contentHeight then square.y = 0 end
-- 正确写法（针对玩家移动）
if player.y > display.contentHeight then player.y = 0 end

如果你确实是想操作某个square，那要么把square改成全局变量（不推荐，容易搞混），要么确保你的操作代码在square所在的局部作用域里（比如嵌套在创建square的tap函数里）。

2. 合并重复的`movePlayer`函数

把四个分开的movePlayer合并成一个，这样所有移动逻辑都会生效：

local function movePlayer(event)
    -- 处理左右移动
    player.x = player.x + motionRight + motionLeft
    -- 边界循环
    if player.x > display.contentWidth then
        player.x = 0
    elseif player.x < 0 then
        player.x = display.contentWidth
    end

    -- 处理上下移动
    player.y = player.y + motionUp + motionDown
    -- 边界循环
    if player.y > display.contentHeight then
        player.y = 0
    elseif player.y < 0 then
        player.y = display.contentHeight
    end
end
Runtime:addEventListener("enterFrame", movePlayer)

3. 给`square`加个“退休”机制（可选但很重要）

每次创建square后，当它移出屏幕时，记得把它销毁并移除监听器，避免内存浪费：
比如修改你创建square时的moveSquare函数（以向下移动的为例）：

local function moveSquare(event)
    square.y = square.y + motionSquare
    -- 当square跑出屏幕范围时，销毁它并移除监听器
    if square.y > display.contentHeight or square.y < 0 or square.x > display.contentWidth or square.x < 0 then
        display.remove(square)
        square = nil
        Runtime:removeEventListener("enterFrame", moveSquare)
    end
end