Python包本地导入问题：优先调用本地模块而非已安装包

问题场景 #

我在wpdetect/__main__.py中尝试导入本地utils/print.py里的print_logo()函数，但实际调用的是系统已安装的wpdetect包中的同名函数，需要调整导入逻辑以使用本地模块。

现有代码 #

wpdetect/__main__.py：

'''
    Entry point for wpdetect.
'''

from wpdetect.utils.print import print_logo


def main():
    """Detects if a website is running WordPress."""

    print_logo('1.0.0')


if __name__ == '__main__':
    main()

wpdetect/utils/print.py：

"""
    Print utility of wpdetect.
"""


def print_logo(version):
    """
        Prints the logo with version number.
    """

    if len(version) == 0:
        raise ValueError(
            "Invalid version number. Please provide a valid version.")

    print("wpdetect")
    print(version)

目录结构 #

- pyproject.toml
- other_files_and_folders
- wpdetect
  -- __init__.py
  -- __main__.py
  -- utils
     --- __init__.py
     --- print.py

解决方案 #

方法1：使用相对导入（推荐） #

修改__main__.py中的导入语句为相对导入，明确指定从当前包的utils模块导入：

from .utils.print import print_logo

相对导入会强制Python从当前包（本地wpdetect目录）内查找模块，避免优先加载系统已安装的同名包。

方法2：调整Python路径 #

如果偏好绝对导入，可将项目根目录（包含wpdetect的目录）添加到PYTHONPATH环境变量，让Python优先搜索本地包：

# Linux/macOS终端
export PYTHONPATH=/path/to/your/project/root:$PYTHONPATH

# Windows命令行
set PYTHONPATH=C:\path\to\your\project\root;%PYTHONPATH%

设置后，原有的from wpdetect.utils.print import print_logo语句会优先加载本地模块。

Pylint代码检查兼容方案 #

当使用上述导入方式时，Pylint可能会抛出「导入错误」警告，可通过以下方式解决：

1. 在项目根目录创建.pylintrc文件，添加配置：

[MASTER]
init-hook='import sys; sys.path.insert(0, ".")'

2. 或在运行Pylint时直接指定路径：

pylint --init-hook='import sys; sys.path.insert(0, ".")' wpdetect/

内容的提问来源于stack exchange，提问作者Hasan