推荐使用 pip install tqdm 安装，多 Python 版本时建议 python -m pip install tqdm；安装后 import tqdm 不报错即成功，也可用 conda install tqdm 或虚拟环境安装。

直接用 pip 安装就行，命令很简单：

安装命令（推荐）

在终端或命令提示符中运行：

pip install tqdm

如果系统里有多个 Python 版本（比如同时装了 Python 3.9 和 3.11），建议明确指定 pip 版本，例如：

立即学习“Python免费学习笔记（深入）”；

• pip3 install tqdm（Linux/macOS 常用）
• python -m pip install tqdm（最稳妥，确保用当前 Python 对应的 pip）

验证是否安装成功

安装完后，打开 Python 交互环境，输入：

import tqdm

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

不报错就说明安装成功。也可以试试：

from tqdm import tqdm

再跑个小例子确认可用：

for i in tqdm(range(100)): pass

常见问题

• 如果提示 "pip is not recognized"，说明 pip 没加进系统 PATH，可改用 python -m ensurepip 先启用 pip，再安装。

• 使用 Anaconda 或 Miniconda 的用户，也可以用：conda install tqdm（源默认是 conda-forge，通常能直接找到）。

• 虚拟环境中安装时，确保已激活该环境，再执行 pip install。