python包中__all__的使用-Python教程-PHP中文网

python包中__all__的使用

舞夢輝影

发布： 2025-10-06 14:52:01

原创

159人浏览过

<p>all 是 Python 中用于控制模块导入行为的特殊变量，它是一个字符串列表，定义了模块的公共接口。当使用 from module import 时，Python 只会导入 all 中列出的名称，从而限制未公开的函数、类或变量被意外导入。例如，在 mymodule.py 中设置 all = ['func_a', 'MyClass'] 后，执行 from mymodule import 仅导入 func_a 和 MyClass，而以下划线开头的 _func_b 和 _PrivateClass 不会被导入。这有助于明确模块的公共 API，提升代码可维护性，避免命名冲突，并支持后期重构。建议在开发公共库时始终定义 all，并将其置于模块顶部，配合文档使用，以增强 API 的清晰性和工具支持。</p>

python包中__all__的使用

__all__ 是 Python 中一个特殊的变量，用来控制模块在使用 from module import * 时，哪些名称会被导入。它是一个字符串列表，定义了模块的公共接口。

作用：限制 * 导入的内容

当你在模块中写 from mymodule import *，Python 默认会导入所有不以下划线开头的全局名称。但通过定义 __all__，你可以明确指定只允许导入某些名字。

例如，mymodule.py 内容如下：

__all__ = ['func_a', 'MyClass']
<p>func_a = lambda: print("公开函数")</p><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/00968c3c2c15" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">Python免费学习笔记（深入）</a>”；</p><p>_func_b = lambda: print("私有函数")</p>
                    <div class="aritcle_card">
                        <a class="aritcle_card_img" href="/ai/2246">
                            <img src="https://img.php.cn/upload/ai_manual/001/246/273/68b6be33edbbd983.png" alt="豆包爱学">
                        </a>
                        <div class="aritcle_card_info">
                            <a href="/ai/2246">豆包爱学</a>
                            <p>豆包旗下AI学习应用</p>
                            <div class="">
                                <img src="/static/images/card_xiazai.png" alt="豆包爱学">
                                <span>674</span>
                            </div>
                        </div>
                        <a href="/ai/2246" class="aritcle_card_btn">
                            <span>查看详情</span>
                            <img src="/static/images/cardxiayige-3.png" alt="豆包爱学">
                        </a>
                    </div>
                <p>class MyClass:
pass</p><p>class _PrivateClass:
pass</p>

登录后复制

此时执行 from mymodule import *，只会导入 func_a 和 MyClass，不会导入 _func_b 和 _PrivateClass。