Arch Linux下Python提示“No module named manim”但manim命令正常运行

核心原因 #

直接用python3执行脚本或VS Code默认解释器调用时，使用的是系统全局Python，其sys.path仅包含系统级site-packages；而通过uv安装的Manim不在这个路径里，但manim命令是uv生成的可执行文件，会自动关联正确的Python环境，所以能正常运行。

解决办法 #

1. 用uv关联的Python执行脚本 #

直接通过uv run调用Python，自动加载安装了Manim的环境：

uv run python filename.py

2. 配置VS Code使用正确的Python解释器 #

• 按Ctrl+Shift+P打开命令面板，输入Python: Select Interpreter
• 选择带有uv标识的Python解释器（对应安装Manim的环境）
• 之后VS Code的Manim侧边视图就能正常运行脚本

3. 临时添加uv包路径到sys.path（不推荐长期使用） #

先找到uv安装Manim的路径：

uv pip install manim --dry-run

从输出中提取安装路径（通常类似~/.local/share/uv/python3.13/site-packages），然后在脚本开头添加：

import sys
sys.path.append("你的uv包安装路径")
from manim import *

4. 配置PYTHONPATH环境变量（用户级安装适用） #

如果是用uv pip install --user manim安装的，先获取用户site-packages路径：

python3 -c "import site; print(site.getusersitepackages())"

然后设置环境变量：

export PYTHONPATH=$(python3 -c "import site; print(site.getusersitepackages())"):$PYTHONPATH

设置后再运行python3 filename.py即可找到模块

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