Manim报错‘模块内无场景’：原有可运行代码突然失效原因排查

此前渲染多个基础图形示例均运行正常，但原本可正常执行的正方形生成代码突然抛出该错误。

原可正常运行的代码：

from manim import *

class SquareMaking(Scene):
    def construct(self):
        square = Square(side_length=2, color=BLUE)
        self.play(Create(square))
        self.wait(1)

        # Change Start and End Angles (Creating an arc)
        square.set_start_angle(-PI/4)
        square.set_end_angle(PI/2)
        self.wait(1)

可能的原因及解决方法 #

• 文件与命令的匹配问题
  执行Manim命令时，要确保指定的文件名和实际文件名完全一致（包括大小写、后缀.py）。比如文件名为square_demo.py，却用了manim -p square.py SquareMaking，就会找不到模块。另外，文件路径不能包含空格、特殊字符，否则可能导致解析失败。

• 代码结构被破坏
  检查代码是否被意外修改：

  • 确认SquareMaking类是否正确继承自Scene，且类定义的缩进、冒号没有缺失；
  • 类名是否拼写正确（比如不小心写成SquareMake）；
  • 代码中是否存在语法错误（比如漏写括号、缩进错误），语法错误会导致Python无法正常加载模块，Manim自然识别不到场景类。可以先用python your_file.py运行代码，排查基础语法问题。

• 环境或版本冲突

  • 确认当前使用的Manim版本与之前一致：不同分支（比如ManimCE和ManimGL）的命令格式有差异，比如ManimCE需要指定场景类名，而ManimGL不需要；如果之前用ManimCE，现在误切换到ManimGL环境，就可能报错。
  • 检查虚拟环境是否正确激活：如果用了虚拟环境，确保激活的是之前正常运行的那个环境，避免依赖版本不匹配。

• 模块加载异常
  可以通过Python命令手动测试模块加载：

  python -c "import your_file_name; print(dir(your_file_name))"
  

  如果输出里没有SquareMaking，说明模块加载时没有识别到这个类，大概率是代码结构或语法问题；如果能看到，再检查Manim命令的参数是否正确。

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