VSCode运行Manim代码Pylance提示无法解析Manim导入报错

Pylance抛出Import Manim could not be resolved提示，核心原因是VSCode中Pylance语言服务关联的Python解释器，和你实际安装Manim的Python环境不匹配，导致Pylance扫描模块路径时找不到Manim的安装位置，和你写的Manim业务代码本身无关。
少数情况是Manim安装过程中出现路径异常，或者你误装了旧版manimlib包而非正式发布的manim包。

按以下顺序逐一排查即可解决问题：

• 第一步：匹配正确的Python解释器
  1. 按快捷键Ctrl+Shift+P（macOS系统按Cmd+Shift+P）调出VSCode命令面板，输入并选中Python: Select Interpreter选项
  2. 在弹出的环境列表中，选择你安装了Manim的Python 3.10.4对应环境，注意区分全局环境、虚拟环境、conda环境的路径差异
  3. 打开VSCode内置终端，执行命令python -c "import manim; print(manim.__version__)"，如果能正常输出Manim版本号，说明解释器匹配正确，等待10-30秒Pylance完成自动索引后报错就会消失
• 第二步：手动配置Pylance模块搜索路径
  如果选对解释器后报错依然存在，手动给Pylance添加模块搜索路径：
  1. 在VSCode内置终端执行命令python -c "import site; print(site.getsitepackages()[0])"，复制输出的site-packages目录绝对路径
  2. 在项目根目录新建.vscode文件夹，在文件夹内新建settings.json配置文件
  3. 在settings.json中写入如下配置，将路径替换为你刚才复制的site-packages路径：

  {
      "python.analysis.extraPaths": [
          "替换为你复制的site-packages绝对路径"
      ]
  }
  

  4. 再次调出命令面板，执行Developer: Reload Window重载VSCode窗口，等待Pylance重新加载索引即可
• 第三步：排查Manim安装异常
  如果终端执行import manim命令本身就报错，说明Manim没有正确安装到当前环境：
  1. 确认当前终端激活的是你要使用的Python 3.10.4环境，执行pip uninstall manim manimlib -y清理残留的旧包
  2. 执行pip install manim --upgrade重新安装最新正式版Manim，安装完成后再次验证导入是否正常

补充说明：你提供的测试代码不存在语法或导入写法错误，只要Pylance能正确扫描到Manim包路径，报错就会消除，不会影响你通过manim命令行正常渲染动画。

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