背景

最近在進行多模塊集成的時候，出現了import錯誤的現象，雖然直接用絕對目錄解決了，但是顯然不優雅，在復習了有關工作目錄的知識后，了解到了問題所在。故寫此博客，希望對讀者有所幫助。

場景說明

有兩個python文件，一個是A.py一個是B.py。

A文件import B文件，由于在同一個目錄下，所以直接import B。

此時在上一層目錄有一個文件C.py。C文件import了A文件，當運行C文件的時候會導致A文件 import B錯誤。

問題原因

工作目錄（也稱為當前工作目錄或CWD）是文件系統中的一個目錄，它決定了程序在查找文件時所使用的基準路徑。在Python中，當你嘗試打開一個文件、讀取一個模塊或其他資源時，如果你沒有指定完整的路徑，Python通常會相對于工作目錄來查找這些資源。

當A.py嘗試import B時，Python解釋器會在幾個地方查找B.py：

1. 內置模塊（如sys、os等）。
2. 當前工作目錄下的模塊和包。
3. PYTHONPATH環境變量中列出的目錄。
4. 標準庫的安裝位置。
5. 第三方庫的安裝位置（如通過pip安裝的庫）。

如果B.py位于與A.py相同的目錄中，并且當前工作目錄不是該目錄，則導入可能會失敗，因為Python解釋器會在當前工作目錄下查找B.py，而不是A.py所在的目錄。

此時的工作目錄是C文件所在的目錄，該目錄下找不到B文件，所以 import B 會報錯。

解決思路

1. 顯式指定路徑：在打開文件或導入模塊時，始終使用完整或相對于某個固定基準點的路徑。例如，如果你知道B.py相對于A.py的位置，你可以使用from . import B（相對導入）或指定完整的包路徑。

2. 修改工作目錄：在Python程序內部，你可以使用os.chdir()函數來更改當前工作目錄。然而，這種方法可能會導致其他代碼或模塊出現路徑問題，因此應謹慎使用。

3. 使用包結構：將你的代碼組織成包（即包含__init__.py文件的目錄），并使用相對導入來引用包內的其他模塊。這可以確保你的代碼不依賴于外部的工作目錄設置。

4. 設置PYTHONPATH：在啟動Python程序之前，設置PYTHONPATH環境變量，將你的模塊和包的路徑添加到其中。這樣，Python解釋器會在這些路徑中查找模塊，而不僅僅是當前工作目錄和標準庫。

5. 使用絕對路徑：在代碼中始終使用絕對路徑來引用文件和模塊。這可以確保你的代碼在任何工作目錄下都能正常工作，但可能會使代碼更難以移植和維護。

本編者推薦使用 1 和 3 來進行解決。