如何解决Pylint与VSCode、Python在包导入上的冲突问题

针对你带src目录的多包项目，以下是几种简洁的解决方案：

方案一：相对导入+模块式运行（推荐，符合Python包规范） #

• 修改rssita.py中的导入为相对导入：

  from .feeds import RSS_FEEDS
  from .termcolors import PC
  

• 运行代码时，不要直接执行rssita.py，而是在项目根目录用模块方式启动：

  python -m src.rssita.rssita
  

  这种方式下，Pylint能正确识别相对导入，代码也能正常运行，完全符合Python包的设计逻辑。

方案二：配置Pylint路径（无需改代码和运行方式） #

• 保持代码中的导入为from feeds import RSS_FEEDS形式不变
• 在项目根目录创建.pylintrc文件，添加以下配置：

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

  该配置会让Pylint把rssita包的目录加入搜索路径，解决导入报错问题，代码原有运行方式不受影响。

方案三：将src目录加入Python路径 #

• 运行代码前，先把src目录添加到Python的环境路径中：
  • Linux/macOS终端：

    export PYTHONPATH="./src:$PYTHONPATH"
    

  • Windows CMD：

    set PYTHONPATH=./src;%PYTHONPATH%
    

  • Windows PowerShell：

    $env:PYTHONPATH = "./src;" + $env:PYTHONPATH
    

• 之后代码中使用绝对导入from rssita.feeds import RSS_FEEDS，Pylint和运行环境都能正常识别。

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