已通过pip安装tqdm但运行报错No module named 'tqdm'如何解决？

• 多版本Python环境冲突：执行pip install tqdm调用的pip，和运行代码时调用的Python解释器不属于同一环境，是该问题最常见的诱因。比如系统同时安装了多个Python版本、虚拟环境未激活时安装包，都会出现pip安装的包无法被运行代码的Python识别的情况。
• IDE解释器配置错误：IDE中指定的项目Python解释器，和安装tqdm所用pip对应的解释器路径不匹配。
• 安装权限不足：无管理员权限时安装的包仅对当前用户可见，运行代码的环境如果没有对应用户目录的读取权限，也会触发导入错误。

1. 对齐pip与Python解释器路径
   先执行命令查看两者路径是否匹配：

• Linux/macOS执行：
  which python3
which pip3
• Windows执行：
  where python
where pip
  如果路径不匹配，直接用你运行代码的Python解释器执行安装命令，确保包被安装到对应环境：
  python3 -m pip install tqdm
  如果运行代码用的是指定版本的Python（比如python3.10），将命令替换为python3.10 -m pip install tqdm即可。

2. 检查虚拟环境状态
   如果你使用venv、conda等虚拟环境，运行代码前先确认虚拟环境已激活：

• venv（Linux/macOS）：source 虚拟环境目录/bin/activate
• venv（Windows cmd）：虚拟环境目录\Scripts\activate.bat
• venv（Windows PowerShell）：虚拟环境目录\Scripts\Activate.ps1
• conda：conda activate 环境名称
  激活后重新执行pip install tqdm即可。

3. 修正IDE解释器配置
   如果是在IDE中运行时报错，手动指定项目的Python解释器为已安装tqdm的环境路径即可：

• PyCharm：依次进入File → Settings → Project: 你的项目名 → Python Interpreter，在下拉列表选择对应环境，或手动添加解释器路径。
• VSCode：按下Ctrl+Shift+P（macOS按Cmd+Shift+P），搜索Python: Select Interpreter，选择对应环境的解释器即可。

4. 修复权限问题
   如果是权限不足导致的安装异常，Linux/macOS可加--user参数将包安装到用户目录：
   python3 -m pip install --user tqdm
   Windows可使用管理员身份打开终端后重新执行安装命令。

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