知识卡片

普通读书笔记卡 · 5913.a.1.b.1.a

通配导入削弱名称来源边界

理解等级:中级

from module import *批量绑定模块导出的名称,容易覆盖同名本地绑定并使来源不清;显式导入所需名称或保留模块限定名更便于追踪。导出集合也受all或默认下划线规则影响,并非无条件导入每个顶层名称。Python3这种形式限模块层使用。

显式from也可能覆盖当前同名绑定;普通import虽然不铺开成员,绑定模块名时同样可能覆盖该名称。保留清楚来源与别名比只选某一种语句就认为永无冲突更可靠。

包的all可指定通配导入应导出的名称,包含合适的子模块名时可触发相应加载;缺少它不表示自动扫描并载入全部子模块。包初始化中显式建立的属性与导出列表是接口设计选择,不是强制私有保护。

有all时按其中列出的名称导出;无all时通常排除下划线开头名称。故即使以下划线命名,也可被all明确列入通配导出,这与默认过滤不同。两种机制都不禁止显式导入或module.attr访问。

多个from *可能按执行次序覆盖同名func,阅读调用处难以看出来源。显式列名、别名或模块限定能让依赖更清楚;即使只用一次星号导入也不自动排除内置名称、本地重绑等其他来源。

默认星号导入过滤下划线名,但显式all可列入它们,不能无条件说下划线名永远不导出。显式访问与模块接口惯例分开理解。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 6 处

    • · 查看原书依据

      把一个模块的命名空间融入另一个模块之中;同样地,实际效果就是可以让我们少输入一些。 就是这样,模块使用起来其实很容易。不过,为了进一步了解定义和使用模块时,究竟会发生什么,我们详细地看一下它们的某些特性吧。 注意:在Python 3.0中,这里所描述的from...*语句形式只能用在一个模块文件的顶部,不能用于一个函数中。Python 2.6允许它用在一个函

    • · 查看原书依据

      悄悄地覆盖掉。使用简单import语句时就不存在这种问题,因为你一定得通过模块名才能获取其内容(module.attr不会和你的作用域内的名为attr的变量相冲突)。不过,使用from时,只要你了解并预料到可能发生这种事,在实际情况下这就不是一个大问题了,尤其当你明确列出导入的变量名时(例如,from module import x,y,z)。 另一方面,和

    • · 查看原书依据

      from*语句的行为 作为一个高级功能,你可以在__init__.py文件内使用__all__列表来定义目录以from*语句形式导入时,需要导出什么。在__init__.py文件中,__all__列表是指当包(目录)名称使用from*的时候,应该导入的子模块的名称清单。如果没有设定__all__,from*语句不会自动加载嵌套于该目录内的子模块。取而代之的是

    • · 查看原书依据

      Python会先寻找模块内的__all__列表;如果没有定义的话,from*就会复制出开头没有单下划线的所有变量名。 就像_X惯例一样,__all__列表只对from*语句这种形式有效,它并不是私有声明。模块编写者可以使用任何一种技巧实现模块,在碰上from*时,能良好地运行(参考第23章中有关包__init__.py文件内__all__列表的讨论,那些列表

    • · 查看原书依据

      没有办法知道简单的函数调用真正含义,除非去搜索这三个外部的模块文件(三个可能都在其他目录内)。 解决办法就是不要这么做:试着在from语句中明确列出想要的属性,而且限制在每个文件中最多只有一个被导入的模块使用from*这种形式。如此一来,任何未定义的变量名一定可以减少到某一个from*所代表的模块。如果你总是使用import而不是from,就可完全避开这个问

    • · 查看原书依据

      单个下划线开头时,当使用from*语句形式导入,这些变量名不会被复制到进行导入的作用域中。不过,这类变量名还是可通过import或者普通的from语句形式来导入。 2.如果模块的__name__变量是字符串"__main__",代表了该文件是作为顶层脚本运行的,而不是被程序中另一个文件所导入的。也就是说,这个文件作为程序在使用,而不是一个库。 3.用户输入脚

    参考来源

    - 位置:《Python学习手册(原书第4版)》第22章《from*语句》(spine808;extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part0779.html;u489-ch22-001)。 - 结论依据:原文在“把一个模块的命名空间融入另一个模块之中”附近的定义、例子或代码支撑本卡核心说明:from module import *批量绑定模块导出的名称,容易覆盖同名本地绑定并使来源不清;显式导入所需名称或保留模块限定名更便于追踪。边界按已读前提解释;示例未执行。 - 原始内容:把一个模块的命名空间融入另一个模块之中;同样地,实际效果就是可以让我们少输入一些。 就是这样,模块使用起来其实很容易。不过,为了进一步了解定义和使用模块时,究竟会发生什么,我们详细地看一下它们的某些特性吧。 注意:在Python 3.0中,这里所描述的from...*语句形式只能用在一个模块文件的顶部,不能用于一个函数中。Python 2.6允许它用在一个函 - 位置:《Python学习手册(原书第4版)》第22章《from语句潜在的陷阱》(spine813;extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part0784.html;u494-ch22-001)。 - 结论依据:显式from也可能覆盖当前同名绑定;普通import虽然不铺开成员,绑定模块名时同样可能覆盖该名称。保留清楚来源与别名比只选某一种语句就认为永无冲突更可靠。 - 原始内容:悄悄地覆盖掉。使用简单import语句时就不存在这种问题,因为你一定得通过模块名才能获取其内容(module.attr不会和你的作用域内的名为attr的变量相冲突)。不过,使用from时,只要你了解并预料到可能发生这种事,在实际情况下这就不是一个大问题了,尤其当你明确列出导入的变量名时(例如,from module import x,y,z)。 另一方面,和 - 位置:《Python学习手册(原书第4版)》第23章《__init__.py包文件》(spine824;extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part0795.html;u509-ch22-001)。 - 结论依据:包的__all__可指定通配导入应导出的名称,包含合适的子模块名时可触发相应加载;缺少它不表示自动扫描并载入全部子模块。包初始化中显式建立的属性与导出列表是接口设计选择,不是强制私有保护。 - 原始内容:from*语句的行为 作为一个高级功能,你可以在__init__.py文件内使用__all__列表来定义目录以from*语句形式导入时,需要导出什么。在__init__.py文件中,__all__列表是指当包(目录)名称使用from*的时候,应该导入的子模块的名称清单。如果没有设定__all__,from*语句不会自动加载嵌套于该目录内的子模块。取而代之的是 - 位置:《Python学习手册(原书第4版)》第24章《最小化from*的破坏:_X和__all__》(spine836;extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part0807.html;u526-ch22-001)。 - 结论依据:有__all__时按其中列出的名称导出;无__all__时通常排除下划线开头名称。故即使以下划线命名,也可被__all__明确列入通配导出,这与默认过滤不同。两种机制都不禁止显式导入或module.attr访问。 - 原始内容:Python会先寻找模块内的__all__列表;如果没有定义的话,from*就会复制出开头没有单下划线的所有变量名。 就像_X惯例一样,__all__列表只对from*语句这种形式有效,它并不是私有声明。模块编写者可以使用任何一种技巧实现模块,在碰上from*时,能良好地运行(参考第23章中有关包__init__.py文件内__all__列表的讨论,那些列表 - 位置:《Python学习手册(原书第4版)》第24章《from*会让变量语义模糊》(spine848;extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part0819.html;u540-ch22-001)。 - 结论依据:多个from *可能按执行次序覆盖同名func,阅读调用处难以看出来源。显式列名、别名或模块限定能让依赖更清楚;即使只用一次星号导入也不自动排除内置名称、本地重绑等其他来源。 - 原始内容:没有办法知道简单的函数调用真正含义,除非去搜索这三个外部的模块文件(三个可能都在其他目录内)。 解决办法就是不要这么做:试着在from语句中明确列出想要的属性,而且限制在每个文件中最多只有一个被导入的模块使用from*这种形式。如此一来,任何未定义的变量名一定可以减少到某一个from*所代表的模块。如果你总是使用import而不是from,就可完全避开这个问 - 位置:《Python学习手册(原书第4版)》第24章《习题解答》(spine854;extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part0825.html;u546-ch22-001)。 - 结论依据:默认星号导入过滤下划线名,但显式__all__可列入它们,不能无条件说下划线名永远不导出。显式访问与模块接口惯例分开理解。 - 原始内容:单个下划线开头时,当使用from*语句形式导入,这些变量名不会被复制到进行导入的作用域中。不过,这类变量名还是可通过import或者普通的from语句形式来导入。 2.如果模块的__name__变量是字符串"__main__",代表了该文件是作为顶层脚本运行的,而不是被程序中另一个文件所导入的。也就是说,这个文件作为程序在使用,而不是一个库。 3.用户输入脚