Pygame开发中Python报UnboundLocalError：SIN_COUNTER变量未定义

这是Python变量作用域的基础规则问题，和Pygame本身无关。
只要你在函数内部对某个变量做了赋值操作（SIN_COUNTER += 8本质是SIN_COUNTER = SIN_COUNTER + 8，属于赋值行为），Python就会默认把这个变量标记为函数内的局部变量，不会自动去外层全局作用域找同名变量。代码执行到等号右侧要读取SIN_COUNTER的值时，局部作用域里的这个变量还没完成赋值，就会抛出你看到的UnboundLocalError: local variable 'SIN_COUNTER' referenced before assignment。
你提到其他全局定义的变量可以正常使用，是因为你在函数里只是读取那些变量的值、没有对它们做赋值，这种情况下Python找不到局部变量时会自动向外层查找全局变量，自然不会报错。

方法1：声明全局变量（快速修复） #

在update函数开头加global关键字，明确告知Python这个变量来自全局作用域，不要按局部变量处理：

import math

# 全局变量定义
SIN_COUNTER = 0

def update():
    global SIN_COUNTER
    SIN_COUNTER += 8
    SIN_COUNTER = math.sin(SIN_COUNTER)

方法2：类封装状态（游戏开发推荐写法） #

做游戏时全局变量堆多了后期很难维护，更规范的做法是把游戏状态封装到类中，用实例属性存储计数器这类动态值，从根源上避开全局变量的作用域坑：

import math
import pygame

class Game:
    def __init__(self):
        self.sin_counter = 0  # 计数器作为游戏实例的属性存储

    def update(self):
        self.sin_counter += 8
        self.sin_counter = math.sin(self.sin_counter)

# 实际使用时先初始化游戏实例，主循环里调用update即可
# game = Game()
# while running:
#     game.update()

小提示：你当前的逻辑有个容易踩的小坑：第一次执行完SIN_COUNTER = math.sin(SIN_COUNTER)后，变量值会被覆盖为-1到1之间的正弦计算结果，后续累加8再算正弦虽然能跑，但如果你原本是想保留持续累加的计数、单独存储正弦计算结果，建议拆成两个独立变量，避免计数被计算结果覆盖。

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