[Python源码学习]之模块路径

tanggang1740

接前面Python源码笔记之Py_InitializeEx，尝试看看Python中用到的一些Path
(这部分东西太乱了...具体见PC/getpathp.c 和 Modules/getpath.c 中的注释)。
一个Python程序要有运行，必须要能找到 .py/.pyc/.pyo/.pyd/.so 等，如何找到这些模块，还真是个问题：

sys.executable	可执行程序完整路径(其他函数可据此查找python运行时需要的库)
sys.prefix	平台无关文件	Python安装路径，用来生成标准库搜索路径
sys.exec_prefix	平台相关文件
sys.path	模块搜索路径

prefix 和 exec_prefix，平时用，几乎总是一样的，应该不用细分。

		常见默认值
Unix (pure)	prefix/lib/pythonX.Y	/usr/local/lib/pythonX.Y
Unix (non-pure)	exec-prefix/lib/pythonX.Y/	/usr/local/lib/pythonX.Y
Windows	prefix\Lib	C:\PythonXY\Lib\

何处初始化？


这4个均在Py_InitializeEx进行初始化：

	初始值
executable	Py_GetProgramFullPath()
prefix	Py_GetPrefix()
exec_prefix	Py_GetExecPrefix()
path	Py_GetPath()

• 
  
  _PySys_Init()
  

PyObject *
_PySys_Init(void)
{
    SET_SYS_FROM_STRING("executable",
                        PyUnicode_FromWideChar(
                               Py_GetProgramFullPath(), -1));
    SET_SYS_FROM_STRING("prefix",
                        PyUnicode_FromWideChar(Py_GetPrefix(), -1));
    SET_SYS_FROM_STRING("exec_prefix",
                        PyUnicode_FromWideChar(Py_GetExecPrefix(), -1));
...

• 
  
  PySys_SetPath(Py_GetPath());
  

void
PySys_SetPath(const wchar_t *path)
{
    PyObject *v;
    if ((v = makepathobject(path, DELIM)) == NULL)
        Py_FatalError("can't create sys.path");
    if (PySys_SetObject("path", v) != 0)
        Py_FatalError("can't assign sys.path");
    Py_DECREF(v);
}


环境变量


与这些path相关的有两个环境变量非常关键：

• PYTHONHOME
  

用来指定 prefix 和 exec_prefix 的值，格式："ThePrefixPath" 或 "ThePrefixPath:TheExec_prefixPath"。注意，指定两个路径时，用冒号分割。
如果使用Py_SetPythonHome()设置了home值，则不会使用环境变量指定的值！

• PYTHONPATH
  

设置模块的默认搜索路径，路径间分隔符和平台相关：Windows下分号，其他平台冒号。


3个函数


除了前面的环境变量，下面3个函数也很重要(在Py_InitializeEx之前调用)

• 
  
  Py_SetProgramName()
  
  
• 
  
  Py_SetPythonHome()
  
  
• 
  
  Py_SetPath()
  
  

注意：使用Py_SetPath()以后，prefix和exec_prefix都将为空。Manual中说多个路径采用分号分割！这是错的，应该是和平台相关，Windows下用分号，其他平台冒号。


路径确定


大致分两步：

• 首先确定 prefix 和 exec_prefix
  
• 
  
  然后，在prefix和exec_prefix上面追加libpath(比如lib/pythonXX/)以及宏PYTHONPATH中指定的路径(比如在linux下，可能是L":plat-linux2")
  
  

prefix


prefix 的确定（linux下）：

• 
  
  如果PYTHONHOME被设置(无论是环境变量，还是Py_SetPythonHome())，则无条件使用它。
  
  
• 
  
  否则，按照可执行程序所在路径(Py_SetProgramName)依次往上搜索(准则是：lib/pythonXX/os.py(os.pyc、os.pyo)文件)
  
  
• 否则，使用configure时设置的值
  

Windows下，prefix和exec_prefix没多大意思了，主要就是确定Pyathon的主目录：

• 如何PYTHONHOME被设置，则使用
  
• 否则，按照可执行程序所在目录向上搜索 (lib/os.py)
  
• 否则，查找注册表
  

path


即 sys.path 的初始值：

• 
  
  如果使用Py_SetPath()设置了路径，则直接使用这些路径
  
  
• 反之：按下面的规则生成
  
  
  
  • 首先添加：环境变量 PYTHONPATH 设置的路径
    
  • 其次：默认的zip文件路径(和prefix相关)，比如：prefix/lib/pythonXX.zip
    
  • 
    
    再次：编译期设置的一些路径(通过宏PYTHONPATH)，和prefix合并成得到的路径，比如：
    
    
    
    • prefix/lib/python3.2
      
    • prefix/lib/python3.2/plat-linux2
      
    
    
    
  • 最后：动态加载模块的路径(和exec_prefix相关)，比如：exec_prefix/lib/python3.2/lib-dynload
    
  
  
  

于是，在linux下，可以见到：

'/usr/lib/python3.2'	.py/.pyc/.pyo
'/usr/lib/python3.2/plat-linux2'	平台相关的 .py/.pyc/.pyo
'/usr/lib/python3.2/lib-dynload'	动态库的 .so

参考

• 
  
  http://docs.python.org/py3k/using/cmdline.html#envvar-PYTHONHOME
  
  
• 
  
  http://docs.python.org/py3k/c-api/init.html
  
  
• 
  
  http://docs.python.org/py3k/install/index.html