如何让Python脚本内全局变量对导入脚本私有（类C static模块变量）

在Python中，我们可以实现类似C语言static模块变量的效果——让变量仅在定义它的脚本内部可用，外部导入该脚本的代码无法访问。以下是具体实现方案：

问题场景回顾 #

现有示例代码：

a.py #

var_a = "hello"

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

b.py #

from a import var_a

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

运行b.py的结果：

$ python3 b.py
In script a.py: hello
In script b.py: hello

需求是让b.py尝试引用var_a时触发错误。

解决方案 #

1. 使用单下划线命名+__all__规范（推荐） #

Python没有真正的私有变量，但约定单下划线_开头的变量为模块内部私有，外部不应导入。配合__all__变量可以限制from a import *的导入范围，进一步强化私有性：

修改后的a.py：

__all__ = []  # 仅列出允许外部导入的名称，这里为空表示不允许导入任何变量
_var_a = "hello"  # 单下划线开头，标识为内部私有

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

此时：

• 若b.py执行from a import _var_a，技术上仍能导入，但这违反Python编码规范，IDE会给出警告
• 若b.py执行from a import *，不会导入_var_a
• 直接通过import a; print(a._var_a)也能访问，但同样属于不规范操作

2. 闭包封装（完全隐藏变量） #

如果要让变量彻底无法被外部访问，可以将变量放在闭包中，仅暴露需要的函数：

修改后的a.py：

def _init_internal():
    # 该变量仅在闭包内部可见，模块级无此变量
    var_a = "hello"

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

# 仅暴露函数到模块级
print_var = _init_internal()
print_var()

此时b.py无论怎么导入a模块，都无法获取var_a，尝试from a import var_a会直接触发ImportError。

3. 类私有属性封装（适合类结构场景） #

如果模块本身需要类结构，可以用双下划线__开头的私有属性，Python会自动对其进行名称修饰，阻止直接访问：

修改后的a.py：

class _ModulePrivate:
    __var_a = "hello"  # 双下划线开头，会被修饰为_ModulePrivate__var_a

    @classmethod
    def use_var(cls):
        print("In script a.py:", cls.__var_a)

_ModulePrivate.use_var()

外部导入后，无法直接通过_ModulePrivate.__var_a访问，必须通过类提供的方法操作变量，技术上即使知道修饰后的名称，也属于不规范访问。

总结 #

Python没有C语言那样原生的static模块变量，但可以通过以下方式实现类似的隐藏效果：

• 优先使用单下划线命名+__all__，遵循Python编码规范，兼顾易用性和私有性
• 若需要完全隐藏变量，使用闭包封装
• 模块有类结构时，可使用类私有属性

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