已安装albumentations仍报ModuleNotFoundError的解决求助

1. 确认当前使用的Python解释器路径 #

先明确运行代码时调用的Python版本及路径：

• 在终端执行：

which python  # Linux/macOS
where python  # Windows

• 或在Python交互环境中执行：

import sys
print(sys.executable)

2. 匹配pip与Python版本 #

检查安装albumentations的pip是否对应目标Python解释器：

pip --version  # 查看输出中的Python版本和路径
pip3 --version # 若使用Python3，优先检查pip3

如果pip与目标Python不匹配，直接用对应Python的内置pip重新安装：

# 替换为第一步得到的Python路径
/path/to/your/python -m pip install --upgrade albumentations

3. 验证包安装路径与Python搜索路径 #

查看albumentations的实际安装位置：

pip show albumentations

复制输出中的Location路径，然后检查该路径是否在Python的搜索列表中：

import sys
print(sys.path)

若不在，可在代码开头手动添加路径：

import sys
sys.path.append("/复制的Location路径")
import albumentations

4. 虚拟环境排查 #

如果使用了虚拟环境，确保激活对应环境后再执行安装和运行操作：

• Linux/macOS激活命令：source /path/to/venv/bin/activate
• Windows激活命令：.\venv\Scripts\activate
  激活环境后重新执行安装命令，再运行代码。

5. 清理重装 #

若以上步骤无效，尝试彻底卸载后重装：

pip uninstall -y albumentations
# 用目标Python的内置pip指定版本重装
/path/to/your/python -m pip install albumentations==1.3.1

内容的提问来源于stack exchange，提问作者Joyanta J. Mondal