Python 包內的導入問題（絕對導入和相對導入）

基本概念

Python 中的包，即包含 __init__.py 文件的文件夾。

對於 Python 的包內導入，即包內模塊導入包內模塊，存在絕對導入和相對導入問題。

普通 Python 模塊的搜索路徑

1. 在當前模塊所在路徑中搜索導入模塊

2. 在環境變量 PYTHONPATH 指定的路徑列表中搜索導入模塊

3. 在 sys.path 指定的路徑列表中搜索導入模塊

Python import 的步驟

 Python 全部加載的模塊信息都存放在 sys.modules 字典結構中，當 import 一個模塊時，會按以下步驟來進行

1. 若是 import A，檢查 sys.modules 中是否已經有 A，若是有則不加載，若是沒有則爲 A 建立 module 對象，並加載 A，便可以重複導入，但只加載一次。
2. 若是 from A import B，先爲 A 建立 module 對象，再解析 A，從中尋找 B 並填充到 A 的 __dict__ 中。

相對導入與絕對導入

絕對導入的格式爲 import A.B 或 from A import B，相對導入格式爲 from .A import B 或 from ..X import Y，. 表明當前模塊，.. 表明上層模塊，... 表明上上層模塊，依次類推。

相對導入對於包的維護優點

相對導入能夠避免硬編碼帶來的包維護問題，例如咱們改了某一層包的名稱，那麼其它模塊對於其子包的全部絕對導入就不能用了，可是採用相對導入語句的模塊，就會避免這個問題。

須要注意：存在相對導入語句的模塊，是不能直接運行的。 例如，對於以下層次結構的 Digital.py 文件，

#!/usr/bin/env python
# -*- coding: utf-8 -*-
##############################################################################
# Purpose: to demo underlayer import upperlayer.
##############################################################################
#
#      \PHONE
#      │  common_util.py   -> setup()
#      │  __init__.py
#      │
#      ├─Fax
#      │      G3.py        -> bar()
#      │      __init__.py
#      │
#      ├─Mobile
#      │      Analog.py    -> foo()
#      │      Digital.py
#      │      __init__.py
#      │
#      ├─Pager
#      │      Page.py
#      │      __init__.py
#      │
#      └─Voice
#              Isdn.py
#              __init__.py
#
##############################################################################

from .Analog import foo          # ValueError: Attempted relative import in non-package
from ..common_util import setup  # ValueError: Attempted relative import in non-package
from ..Fax.G3 import bar         # ValueError: Attempted relative import in non-package

if __name__ == '__main__':

    foo()
    setup()
    bar()

若是上述代碼直接運行，將致使 ValueError 異常，

ValueError: Attempted relative import in non-package

這是由於：一個模塊直接運行，Python 認爲這個模塊就是頂層模塊，不存在層次結構，因此找不到其它的相對路徑。

而要正確運行，就要顯式的指定路徑，以下，

C:\workspace\X_python>python -m Phone.Mobile.Digital
This is foo() from Phone.Mobile.Analog
This is setup() from Phone.common_util
This is bar() from Phone.Fax.G3

固然，咱們通常不會直接運行包內的某個模塊，這裏只是作個說明。

絕對導入對於包維護的劣勢

例如，對於以下層次結構的 Digital.py 文件，

#!/usr/bin/env python
# -*- coding: utf-8 -*-
##############################################################################
# Purpose: to demo underlayer import upperlayer.
##############################################################################
#
#      \PHONE
#      │  common_util.py   -> setup()
#      │  __init__.py
#      │
#      ├─Fax
#      │      G3.py        -> bar()
#      │      __init__.py
#      │
#      ├─Mobile
#      │      Analog.py    -> foo()
#      │      Digital.py
#      │      __init__.py
#      │
#      ├─Pager
#      │      Page.py
#      │      __init__.py
#      │
#      └─Voice
#              Isdn.py
#              __init__.py
#
##############################################################################

# from .Analog import foo          # ValueError: Attempted relative import in non-package
# from ..common_util import setup  # ValueError: Attempted relative import in non-package
# from ..Fax.G3 import bar         # ValueError: Attempted relative import in non-package

from Phone.Mobile.Analog import foo
from Phone.common_util import setup
from Phone.Fax.G3 import bar

if __name__ == '__main__':

    foo()
    setup()
    bar()

上述代碼能夠直接運行。
可是，絕對導入的硬編碼模式，若是在包中存在不少 Digital.py 相似模塊，都採用了 from Phone.common_util import setup 的語句，若是有一天要更改 common_util 包（文件夾）的名字，那麼會影響全部相關的代碼。而採用相對導入就沒有這個問題。

不過，絕對導入更清晰，若是包不是特別複雜，不是特別易變，那麼仍是建議採用絕對導入。(我的觀點，僅供參考)

 

再舉一個包內導入的例子，目錄結構爲，

#   myabc/
#   ├── abc.py
#   ├── __init__.py
#   └── xyz.py

# abc.py

def foo():
    print("This is foo from local abc module!")

# xyz.py

##########################################
#import .abc                  # invalid
#import . abc                 # invalid
##########################################

#from .abc import foo          # valid
from . abc import foo          # valid

def bar():
    print('bar - ', end='')
    foo()

外部使用 myabc 包，

>>> import myabc.xyz
>>> myabc.xyz.bar()
bar - This is foo from local abc module!
>>> 
>>> from myabc import xyz
>>> xyz.bar()
bar - This is foo from local abc module!
>>> 
>>> 
>>> import myabc.abc
>>> myabc.abc.foo()
This is foo from local abc module!
>>> 
>>> from myabc import abc
>>> abc.foo()
This is foo from local abc module!

 

再舉個例子， 

#    myfact/
#    ├── factory.py
#    ├── __init__.py
#    └── xyz.py

# factory.py 
def foo():
    print("This is foo from local abc module!")


# xyz.py ####################################################################################
#from factory import foo            # Invalid!  ModuleNotFoundError: No module named 'factory'
####################################################################################

#from myfact.factory import foo      # Valid, absolute
#from .factory import foo            # Valud, relative
from . factory import foo            # Valud, relative

def bar(): 
    print('bar - ', end='') 
    foo()

外部使用 myfact 包，

>>> import myfact.xyz
>>> 
>>> myfact.xyz.bar()
bar - This is foo from local abc module!

 

 

完。