python 无法将“pyinstaller”项识别为 cmdlet、函数、脚本文件或可运行程序的名称

如果您喜欢此文章，请收藏、点赞、评论，谢谢，祝您快乐每一天。

异常信息：pyinstaller : 无法将“pyinstaller”项识别为 cmdlet、函数、脚本文件或可运行程序的名称。请检查名称的拼写，如果包括路径，请确保路径正确，然后再试一次。
所在位置 行:1 字符: 1
+ pyinstaller --version
+ ~~~~~~~~~~~
    + CategoryInfo          : ObjectNotFound: (pyinstaller:String) [], CommandNotFoundException
    + FullyQualifiedErrorId : CommandNotFoundException

按照下面的图片提示，实际我已经安装了pyinstaller：

安装完成后，在控制台执行 pyinstaller --version 命令依然报错：

仔细看过安装信息以后，才发现警告信息中有提示：

Installing collected packages: altgraph, zipp, pywin32-ctypes, pefile, packaging, importlib-metadata, pyinstaller-hooks-contrib, pyinstaller
  WARNING: The scripts pyi-archive_viewer.exe, pyi-bindepend.exe, pyi-grab_version.exe, pyi-makespec.exe, pyi-set_version.exe and pyinstaller.exe are installed in 'C:\Users\xxxf\AppData\Roaming\Python\Python39\Scripts' which is not on PATH.
  Consider adding this directory to PATH or, if you prefer to suppress this warning, use --no-warn-script-location.
Successfully installed altgraph-0.17.5 importlib-metadata-8.7.0 packaging-25.0 pefile-2024.8.26 pyinstaller-6.17.0 pyinstaller-hooks-contrib-2025.10 pywin32-ctypes-0.2.3 zipp-3.23.0
WARNING: You are using pip version 22.0.4; however, version 25.3 is available.
You should consider upgrading via the 'C:\Program Files (x86)\Microsoft Visual Studio\Shared\Python39_64\python.exe -m pip install --upgrade pip' command.

本文根据第一条警告查看对应目录是否安装 pyinstaller：

紧接着设置环境变量，本文是windows11，右键点击此电脑-属性：

找到高级系统设置：

点击环境变量：

点击path-编辑：

点击新建，将python目录：C:\Users\xxxf\AppData\Roaming\Python\Python39\Scripts 添加到变量里即可：

添加完成后，一直确定按钮即可。

在cmd窗口执行 pyinstaller --version，信息如下：

说明环境变量配置成功。

如果您喜欢此文章，请收藏、点赞、评论，谢谢，祝您快乐每一天。