PYTHONPATH 工程路径
在 Python 中，PYTHONPATH 是一个环境变量，用于告诉解释器去哪里寻找导入的模块。当我们在代码中使用 import 语句导入一个模块时，解释器会按照 PYTHONPATH 指定的路径顺序搜索该模块的位置。如果找不到该模块，则会抛出 ModuleNotFoundError 异常。
设置 PYTHONPATH
要设置 PYTHONPATH 环境变量，可以通过以下几种方式：
1. 使用命令行参数
可以在启动 Python 解释器时使用 -m 选项和 sys 模块的 path 属性来设置 PYTHONPATH。例如：
python -m sys -c "import sys; sys.path.append('/path/to/project')"
这样可以在运行 Python 脚本时，临时地添加指定的路径到 PYTHONPATH 中。
2. 修改环境变量
在操作系统中，可以永久地设置 PYTHONPATH 环境变量。以 Linux 为例，在命令行中执行以下命令：
export PYTHONPATH=/path/to/project
这样设置后，以后打开的终端会话中都会生效。
3. 使用 site 模块
Python 的 site 模块提供了一个 sitecustomize 文件，可以用来设置 PYTHONPATH。将下面的代码保存为 sitecustomize.py 文件，并放在 Python 安装目录下的 site-packages 目录中：
import sys
sys.path.append('/path/to/project')
这样每次启动 Python 解释器时，都会自动将指定的路径添加到 PYTHONPATH 中。
使用 PYTHONPATH
一旦设置了 PYTHONPATH，我们就可以在 Python 代码中使用 import 语句导入指定路径下的模块。例如，假设我们有一个名为 math_utils.py 的模块，位于 /path/to/project 目录下：
import math_utils
result = math_utils.add(2, 3)
print(result)
在上面的代码中，我们导入了 math_utils 模块，并调用了其中的 add 函数。由于设置了 PYTHONPATH 指向 /path/to/project，解释器能够找到并导入该模块，所以我们可以成功地调用其中的函数。
示例代码
下面是一个更完整的示例，演示了如何设置 PYTHONPATH 并使用导入的模块：
# main.py
import sys
sys.path.append('/path/to/project')
import math_utils
result = math_utils.add(2, 3)
print(result)
# math_utils.py
def add(a, b):
return a + b
状态图
下面是一个使用 mermaid 语法绘制的状态图示例：
stateDiagram
[*] --> A
A --> B
B --> C
C --> [*]
在这个状态图中，有四个状态节点：A、B、C 和 [*]。节点之间的箭头表示状态的转移关系。
总结
通过设置 PYTHONPATH，我们可以告诉 Python 解释器去指定的路径中寻找导入的模块。这对于大型项目或模块的复用非常有用。我们可以通过命令行参数、修改环境变量或使用 site 模块来设置 PYTHONPATH。在代码中使用 import 语句导入模块时，解释器会按照 PYTHONPATH 指定的路径顺序搜索模块的位置。在实际开发中，合理设置 PYTHONPATH 可以提高代码的可维护性和复用性。
希望本文对理解和使用 PYTHONPATH 有所帮助，让你更好地管理和组织 Python 项目。
