Ubuntu22.04下已安装atlassian模块却导入失败，求原因

在Ubuntu22.04系统中执行以下命令安装atlassian模块：

$ pip3 install atlassian
Requirement already satisfied: atlassian in /home/funny/.local/lib/python3.8/site-packages (0.0.0)

编写x.py文件如下：

#!/usr/bin/env python3
from atlassian import Jira

执行pip3 list确认模块已存在：

$ pip3 list |grep atlassian
atlassian               0.0.0

但运行脚本时出现如下错误：

$ ./x.py 
Traceback (most recent call last):
  File "./x.py", line 2, in <module>
    from atlassian import Jira
ModuleNotFoundError: No module named 'atlassian'

1. Python环境版本不匹配 #

pip3将模块安装到了Python3.8的用户目录（/home/funny/.local/lib/python3.8/site-packages），但脚本通过#!/usr/bin/env python3调用的Python版本可能不是3.8（Ubuntu22.04默认Python3版本为3.10），导致两个环境不互通。

验证方法：

# 查看pip3对应的Python版本
pip3 --version
# 查看当前python3的版本
python3 --version

解决办法：

• 直接用对应版本的Python执行脚本：python3.8 x.py
• 修改脚本的解释器路径，把第一行改为#!/usr/bin/env python3.8

2. 虚拟环境冲突 #

如果当前终端处于某个Python虚拟环境中，而模块安装在全局用户目录，虚拟环境内无法访问全局安装的模块，就会触发导入错误。

解决办法：

• 执行deactivate退出当前虚拟环境，再重新运行脚本
• 在虚拟环境内重新安装模块：pip install atlassian

3. 安装的模块版本异常 #

你安装的atlassian版本为0.0.0，属于异常版本，大概率是安装了错误的包（官方提供的Atlassian API包实际名为atlassian-python-api）。

解决办法：

• 卸载异常包：pip3 uninstall atlassian
• 安装官方正确的包：pip3 install atlassian-python-api
• 脚本中的导入语句可保持from atlassian import Jira，新版本兼容该写法

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