如何在 Python 中实现脚本级私有变量-Python教程-PHP中文网

如何在 Python 中实现脚本级私有变量

Python 没有原生的“模块私有全局变量”语法，但可通过作用域控制与模块初始化技巧（如立即执行函数 + del 清理）使变量对导入者不可见，仅暴露显式声明的接口。

python 没有原生的“模块私有全局变量”语法，但可通过作用域控制与模块初始化技巧（如立即执行函数 + `del` 清理）使变量对导入者不可见，仅暴露显式声明的接口。

在 Python 中，模块顶层定义的变量默认是模块级“公有”的——只要其他模块使用 from a import var_a 或 import a; a.var_a，就能直接访问。这与 C 语言中 static 修饰的文件作用域变量行为不同。若希望 var_a 仅在 a.py 内部可用，对外部导入完全隐藏，关键在于避免将其暴露在模块命名空间中。

最实用且符合 Python 惯用法的方案是：将模块逻辑封装在立即执行的函数内，利用函数作用域隔离变量，并仅通过 global 显式导出需公开的名称。例如：

# a.py
def _init_module():
    var_a = "hello"  # ✅ 仅存在于函数作用域内，外部不可见

    print("In script a.py:", var_a)

    # ✅ 显式挂载到模块全局命名空间（仅此一项可被导入）
    global func_a
    def func_a():
        print("In func_a:", var_a)

    # 若需在闭包内修改 var_a，使用 nonlocal（注意：nonlocal 不能跨模块生效，仅限嵌套作用域）
    global update_a
    def update_a():
        nonlocal var_a
        var_a += " (updated)"
        print("Updated:", var_a)

_init_module()
del _init_module  # ? 彻底移除初始化函数，防止残留引用

此时在 b.py 中：

python学习

Python 编程学习助手 skill，面向零基础用户。当用户表达以下意图时触发： - 学习 Python 基础概念（变量、数据类型、循环、函数、类等） - 请求 Python 练习题或测验 - 请求审查或调试 Python 代码 - 请求 Python 项目实战指导（爬虫、数据分析、Web 开发等入门项目） - 泛化表述如"教我 Python""我想学编程""Python 怎么写""帮我学 Python" 此 skill

下载

# b.py
from a import func_a, update_a
func_a()     # 输出: In func_a: hello
update_a()   # 输出: Updated: hello (updated)

# ❌ 以下任一语句均会抛出 ImportError：
# from a import var_a
# import a; print(a.var_a)

⚠️ 注意事项：

global 仅用于将函数内定义的名称绑定到模块顶层；它不改变变量本身的可见性策略，而是配合作用域封装实现“按需导出”。

del _init_module 是重要安全步骤——防止用户通过 a._init_module.__closure__ 等方式间接访问闭包变量（尽管非常规，但能提升封装强度）。

此方法不适用于需要从外部直接读/写变量的场景（如配置参数），此时应改用模块级属性 + __all__ + 文档约定，或封装为类/单例。

__all__ = ["func_a", "update_a"] 可作为补充（影响 from a import *），但无法阻止显式导入未列名的变量——因此作用域隔离仍是根本手段。