Ubuntu 22.04安装manim后运行提示Command 'manim' not found如何解决

API 探路者

2026-8-29

问题描述

运行环境：Ubuntu 22.04 LTS
已完成manim安装流程，运行快速入门提供的CreateCircle测试代码时，进入scene.py所在目录执行命令manim -pql scene.py CreateCircle，终端返回报错：Command 'manim' not found, did you mean:...
原测试代码（存在缩进错误）：

from manim import *
class CreateCircle(Scene):
def construct(self):
    circle = Circle()  # create a circle
    circle.set_fill(PINK, opacity=0.5)  # set the color and transparency
    self.play(Create(circle))  # show the circle on screen

报错原因

这个报错是系统无法在PATH环境变量指定的目录里找到manim可执行文件，Ubuntu新手出现这个问题90%以上是两种情况：一是用pip install --user给当前用户安装时，用户目录下的.local/bin路径默认没有被加入系统PATH；二是把manim装在了Python虚拟环境里，但运行命令前没有激活对应虚拟环境。
另外你贴的测试代码里construct方法没有做类内缩进，就算解决了命令找不到的问题，运行时也会触发语法错误，后面会给出修正后的代码。

解决步骤

按顺序试，哪步通了就不用往下走：

先排查用户本地二进制路径未加入PATH的问题
先在终端执行下面的命令临时把用户本地bin目录加入PATH：
```
export PATH="$HOME/.local/bin:$PATH"
```
执行完直接输入manim --version，如果终端正常输出manim的版本号，说明就是这个问题。执行下面两条命令把路径配置永久写入终端配置，以后重启也不会失效：
如果你用的是系统默认的bash终端，执行：
```
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
```
如果你自己更换了zsh作为默认终端，把上面命令里的.bashrc替换成.zshrc再执行即可。
排查虚拟环境未激活的问题
如果上一步操作完还是提示找不到命令，回忆下你安装manim的时候有没有创建Python虚拟环境（很多安装教程会建议用虚拟环境隔离依赖，一般是一个名为venv或者manimenv的文件夹）。如果有，先进入虚拟环境所在的目录，执行激活命令：
```
source 你的虚拟环境文件夹名称/bin/activate
```
激活成功后终端输入行的开头会出现带括号的虚拟环境名称，这时候再执行manim相关命令就能正常识别。
绕开路径配置，直接用Python模块方式调用
如果不想折腾PATH和虚拟环境的配置，只要你当前的Python环境能正常导入manim库，就可以直接用下面的命令替代原生的manim指令，完全不会出现找不到命令的问题：
```
python3 -m manim -pql scene.py CreateCircle
```

测试代码修正

你之前贴的代码里类方法缩进错误，修正后的可运行代码如下，直接替换原来scene.py里的内容即可：

from manim import *
class CreateCircle(Scene):
    def construct(self):
        circle = Circle()  # create a circle
        circle.set_fill(PINK, opacity=0.5)  # set the color and transparency
        self.play(Create(circle))  # show the circle on screen

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