如何在 Python 函数中正确声明和使用带类型注解的全局变量-Python教程-PHP中文网

如何在 Python 函数中正确声明和使用带类型注解的全局变量

Python 不允许在函数内通过类型注解（如 var: Type = value）方式定义带 global 声明的变量，必须先在模块顶层完成类型声明与初始化，或改用返回值方式避免全局状态。

python 不允许在函数内通过类型注解（如 `var: type = value`）方式定义带 `global` 声明的变量，必须先在模块顶层完成类型声明与初始化，或改用返回值方式避免全局状态。

在 Python 中，global 语句仅用于声明已存在的全局名称，而类型注解（如 bank: Bank = json.load(f)）在语法层面被视为变量标注（annotated assignment），它本质上是局部作用域的定义操作。因此，当编译器遇到 global bank 后又紧接着出现 bank: Bank = ... 时，会直接报错：

SyntaxError: annotated name 'bank' can't be global

这是 Python 语言规范的硬性限制（见 PEP 526），并非类型检查器（如 mypy）警告，而是解释器层面的语法错误。

✅ 正确做法一：顶层声明 + global 赋值（不带注解）

需在函数外部预先声明变量并赋予类型提示（推荐使用 : Type 注解 + 初始化）：

import json

type Bank = dict[str, dict[str, int | float]]  # 注意：str: int | float 是无效语法，应为 str, int | float

# ✅ 在模块顶层声明并初始化（类型注解 + 默认值）
bank: Bank = {}

def get_ball() -> None:
    global bank
    with open("bank.json", "r") as f:
        bank = json.load(f)  # 仅赋值，不重复标注
    print(bank)

get_ball()
print(bank)

⚠️ 注意：原代码中 dict[str: int | float] 是错误写法，正确应为 dict[str, int | float] —— 键值对类型用逗号分隔，冒号仅用于函数签名或变量标注。

Python 3.14.2
Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本，属于3.14系列的第二个维护更新。该版本包含了18项修复，重点解决了多进程、数据类及正则表达式等模块的回归问题，并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式（移除GIL）正式获得官方支持，是Python发展的重要里程碑。

下载

✅ 更优做法二：消除全局状态，返回新对象（推荐）

避免 global 带来的可测试性差、线程不安全、副作用隐晦等问题：

import json

type Bank = dict[str, dict[str, int | float]]

def get_ball() -> Bank:
    """从 bank.json 加载银行数据，返回全新 Bank 实例。"""
    with open("bank.json", "r") as f:
        data = json.load(f)
    # 可选：运行时类型校验（如用 pydantic 或 isinstance）
    if not isinstance(data, dict):
        raise TypeError("bank.json must contain a JSON object")
    return data

# 使用时显式接收返回值
bank: Bank = get_ball()
print(bank)

这种函数式风格更符合 Python 最佳实践：纯函数、无副作用、易于单元测试、天然支持并发与重入。