答案是环境变量未配置和pip版本过低：pyinstaller安装后无法调用，主因是scripts路径未加入系统path，且pyinstaller 2026最新版要求pip≥23.0，旧版pip会导致依赖解析失败或静默安装异常。
直接装就行，但装完可能用不了——问题几乎全出在环境变量和 pip 版本上。
pip install pyinstaller 为什么报“不是内部或外部命令”
这不是 pyinstaller 没装上，而是 pyinstaller 可执行文件所在路径没进系统 PATH。Windows 下常见路径包括：
-
C:\Users\{用户名}\AppData\Roaming\Python\Python311\Scripts（用户级安装） -
C:\Python311\Scripts（全局安装，取决于你装 Python 时是否勾选 “Add Python to PATH”）
手动把对应路径加进系统环境变量的 PATH，再开新终端，pyinstaller --version 就能正常响应。
pip 版本太旧导致安装失败或报错
PyInstaller 2026 年最新版（如 6.10+）已要求 pip ≥ 23.0。旧 pip 会卡在依赖解析、跳过关键子包（比如 altgraph 或 macholib），甚至静默失败。
执行以下命令升级：
python -m pip install --upgrade pip
升级后验证：
pip --version
如果仍报错，说明 pip 被锁在旧版本（常见于 conda 环境或系统 Python），此时建议：
- 改用虚拟环境：
python -m venv .venv && source .venv/bin/activate（macOS/Linux）或.venv\Scripts\activate（Windows） - 或换国内镜像源重装：
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple pyinstaller
装完运行 pyinstaller 却提示 pathlib 报错
错误信息类似：The 'pathlib' package is an obsolete backport。这是 Python 3.4+ 自带 pathlib，但旧版第三方 pathlib 包（非标准库）还留在环境中，与 PyInstaller 冲突。
必须卸载它：
pip uninstall pathlib
注意：别用 conda remove pathlib，conda 管理的 pathlib 往往是其他包的依赖，硬删可能破坏环境。只用 pip uninstall 清掉 pip 安装的冗余 backport。
Linux/macOS 权限拒绝或找不到命令
常见于用 sudo pip install pyinstaller 全局安装后，普通用户仍无法调用 pyinstaller ——因为 sudo 安装的脚本路径（如 /usr/local/bin）可能不在当前用户的 PATH 中，或 shell 缓存未刷新。
更安全的做法是：
- 始终优先用虚拟环境：
python -m venv build_env && source build_env/bin/activate - 然后
pip install pyinstaller——这样路径确定、无权限问题、不污染系统 - 若坚持全局装，检查
which pyinstaller输出，并确认该路径在$PATH里；必要时重启 shell 或运行hash -d pyinstaller清缓存
真正容易被忽略的是：装完不验证就直接打包。哪怕 pip install 显示 success，也务必跑一次 pyinstaller --version 和 pyinstaller --help，否则后续打包失败时，你得倒回去排查到底是没装好，还是代码本身有问题。
