Python如何从指定lib文件夹导入pygame库？导入失败求助

问题原因 #

你用pip install --target=./lib pygame把pygame装到lib目录后，直接用from lib import pygame或import lib.pygame会报错，是因为pygame内部的模块导入用的是绝对导入（比如from pygame.base import *）。当你把pygame放在lib下时，Python默认的搜索路径里没有lib，而且pygame内部不会自动去lib目录下找自己的子模块，所以会触发ModuleNotFoundError。

正确解决步骤 #

1. 确保pygame正确安装到lib目录 #

执行正确的安装命令（替换为你的项目路径）：

pip install --target=./lib pygame

执行后，lib目录下会出现pygame文件夹以及相关依赖文件。

2. 在主脚本中添加lib目录到Python搜索路径 #

在你的游戏主脚本开头，添加以下代码，把lib目录加入Python的模块搜索路径sys.path：

import sys
import os

# 动态获取lib目录的绝对路径（适配不同环境）
lib_path = os.path.join(os.path.dirname(os.path.abspath(__file__)), 'lib')
sys.path.insert(0, lib_path)

# 现在可以直接导入pygame
import pygame

# 初始化pygame验证
pygame.init()
print(pygame.version.ver)

3. 为什么不用from lib import pygame？ #

这种导入方式会把pygame的命名空间变成lib.pygame，但pygame内部的所有导入都是基于顶级的pygame命名空间，比如import pygame.base会去Python的顶级搜索路径找，而不是lib.pygame.base，所以必然报错。直接把lib加入sys.path后，import pygame就和你之前把pygame装在项目根目录的用法完全一致，内部导入也能正常工作。

小游戏lib文件夹的通用实现逻辑 #

大多数带lib文件夹的小游戏都是这么做的：

• 把所有第三方依赖用pip install --target=./lib安装到lib目录
• 在主入口脚本中，先将lib目录添加到sys.path
• 之后直接用常规的import 模块名导入依赖，和正常安装的用法完全一致

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