运行Python类代码时报错，无法安装IPython模块的问题求助

问题描述 #

运行Python代码时触发ModuleNotFoundError: No module named 'IPython'，报错指向代码第3行的from IPython.display import Markdown, display语句；使用PyCharm社区版尝试安装IPython包时也出现安装错误。当前提供的Dog类代码如下：

class Dog:
    """A simple attempt to model a dog."""

    def __init__(self, name, age):
        """Initialize name and age attributes."""
        self.name = name
        self.age = age

        def sit(self):
            """Simulate a dog sitting in response to a command"""
            print(self.name.title() + " is now sitting.")

        def roll_over(self):
            """Simulate rolling over in response to a command"""
            print(self.name.title() + " rolled over!")

my_dog = Dog('Willie', 6)

print("My dog's name is " + my_dog.name.title() + ".")
print("My dog is " + str(my_dog.age) + " years old.")

报错信息：

/usr/bin/python3.12 /home/adnananwar/PycharmProjects/demo-repo/soup.py 
Traceback (most recent call last):
  File "/home/adnananwar/PycharmProjects/demo-repo/soup.py", line 3, in <module>
    from IPython.display import Markdown, display
ModuleNotFoundError: No module named 'IPython'

排查与解决步骤 #

1. 澄清报错根源 #

报错信息明确是第3行的IPython导入语句引发的问题，但你提供的Dog类代码中没有这行代码，可能存在两种情况：

• 你运行的soup.py文件和贴出的Dog类代码不是同一个文件，检查文件名和文件内容是否匹配；
• 代码粘贴不全，遗漏了导入IPython的语句。

2. 解决IPython安装失败问题 #

针对PyCharm中安装IPython失败的情况，按以下步骤尝试：

• 检查PyCharm解释器配置：打开File → Settings → Project: [你的项目名] → Python Interpreter，确认当前使用的是项目对应的虚拟环境（推荐）而非系统全局Python。选中对应解释器后，点击+号搜索ipython进行安装；
• 终端手动安装：打开PyCharm底部的Terminal，直接执行命令：

  pip install ipython
  

  如果是系统Python环境，可添加--user参数避免权限问题：

  pip install ipython --user
  

  或者明确指定Python版本：

  python3 -m pip install ipython
  

• 更换PyPI镜像源：如果是网络问题导致安装超时，使用国内镜像源加速：

  pip install ipython -i https://pypi.tuna.tsinghua.edu.cn/simple
  

• 权限处理（Linux/macOS）：若使用全局Python且出现权限错误，可尝试：

  sudo pip install ipython
  

  （注：优先使用虚拟环境，避免污染系统Python）

3. 修复代码缩进错误 #

你提供的Dog类代码存在缩进问题：sit()和roll_over()方法被缩进在__init__()方法内部，这会导致无法通过实例调用这两个方法。正确的缩进应该是和__init__()同级，修改后代码如下：

class Dog:
    """A simple attempt to model a dog."""

    def __init__(self, name, age):
        """Initialize name and age attributes."""
        self.name = name
        self.age = age

    def sit(self):
        """Simulate a dog sitting in response to a command"""
        print(self.name.title() + " is now sitting.")

    def roll_over(self):
        """Simulate rolling over in response to a command"""
        print(self.name.title() + " rolled over!")

my_dog = Dog('Willie', 6)

print("My dog's name is " + my_dog.name.title() + ".")
print("My dog is " + str(my_dog.age) + " years old.")

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