Python全局变量与global关键字：何时需要声明？

Python中，全局变量的使用有时需要显式声明global关键字，有时则不需要，这常常让新手困惑。本文将通过示例详细解释global关键字的必要性。

问题源于：类方法试图访问和修改全局变量。仅读取时无需global；但修改时，必须使用global。

先看一段可运行代码：

立即学习“Python免费学习笔记（深入）”；

from loguru import logger

success_list = [1, 2, 3, 4, 5, 6, 7, 8]


class MyClass:
    def run(self):
        logger.debug(success_list)  # 只读取全局变量

MyClass().run()
logger.debug(success_list)

MyClass类的run方法只读取全局变量success_list，无需global关键字。Python解释器直接找到并使用全局变量。

python-docx

python-docx Skill功能概述python-docx Skill是一项面向实际任务的技能，主要用于本Skill提供使用python-docx生成专业Word文档的标准方法和最佳实践；生成安全服务方案文档；核心要点生成技术架构设计文档；生成任何需要专业排版的Word文档；核心库 : python-docx；使用与执行辅助库 : docx.shared , docx.enum , docx.oxml.ns；标准代码模板；1. 文档初始化；2. 字体设置（必须！它将相关步骤、工具调用和结果整理方式集

下载

但如果run方法试图修改success_list：

from loguru import logger

success_list = [1, 2, 3, 4, 5, 6, 7, 8]


class MyClass:
    def run(self):
        logger.debug(success_list)
        success_list = success_list[1:]  # 试图修改全局变量
        logger.debug(success_list)

MyClass().run()
logger.debug(success_list)

这段代码会抛出UnboundLocalError异常。Python解释器认为success_list是局部变量，在赋值前就试图使用，导致错误。

解决方法是在run方法中声明global：

from loguru import logger

success_list = [1, 2, 3, 4, 5, 6, 7, 8]


class MyClass:
    def run(self):
        global success_list  # 声明全局变量
        logger.debug(success_list)
        success_list = success_list[1:]
        logger.debug(success_list)

MyClass().run()
logger.debug(success_list)

添加global success_list后，Python解释器知道success_list是全局变量，代码正确运行并修改了全局变量。

结论：关键在于是否修改全局变量。只读取无需global；修改时，必须使用global声明，避免局部变量遮蔽全局变量。