已通过pip安装eth-brownie但运行brownie提示命令未被识别该如何解决？

对应报错信息：

The term 'brownie' is not recognized as the name of a cmdlet, function, script file, or operable program. Check the spelling of the name, or if a path was included, verify that the path is correct and try again. At line:1 char:1

报错核心原因 #

• Python全局包可执行文件路径未加入系统环境变量：pip安装的第三方包可执行脚本默认会存放在Python安装目录下的Scripts文件夹（Windows）或bin目录（macOS/Linux），如果该路径没有被加入系统PATH环境变量，终端就无法识别brownie命令。
• 安装时使用了虚拟环境但运行时未激活：如果eth-brownie是安装在venv、conda等虚拟环境下，只有激活虚拟环境后终端才会读取对应环境的包路径，未激活状态下全局找不到对应命令。
• 安装权限不足导致安装不完整：Windows下未用管理员权限运行终端、macOS/Linux未加sudo安装全局包时，可能出现可执行文件未正确写入对应目录的情况，导致命令缺失。
• Python多版本冲突：设备上同时安装了多个Python版本，pip对应的Python版本和预期运行的版本不一致，导致brownie被安装到其他版本的包目录下，当前使用的Python版本找不到对应命令。

可行解决方法 #

方法1：验证虚拟环境激活状态 #

如果安装时使用了虚拟环境，先执行对应激活命令再试：

• venv（Windows）：.\venv\Scripts\activate
• venv（macOS/Linux）：source venv/bin/activate
• conda：conda activate 你的环境名
  激活后执行brownie命令验证是否可用。

方法2：直接通过Python模块调用 #

不需要修改环境变量，直接通过Python调用brownie模块即可，命令如下：

python -m brownie

如果设备有多版本Python，把python替换成py -3（Windows）或python3（macOS/Linux）即可。

方法3：将Python的Scripts路径加入系统环境变量（Windows为例） #

1. 终端执行pip show eth-brownie，找到Location字段对应的路径，示例：C:\Users\用户名\AppData\Roaming\Python\Python310\site-packages
2. 向上一级找到同目录下的Scripts文件夹，对应路径为C:\Users\用户名\AppData\Roaming\Python\Python310\Scripts
3. 右键「此电脑」-「属性」-「高级系统设置」-「环境变量」，在用户变量的「Path」里新增刚才的Scripts路径，保存后重启终端即可。
   注意：上述路径中的用户名、Python310需要替换为你自己设备的实际用户名和对应的Python版本号。

方法4：重新完整安装 #

如果是安装不完整或者版本冲突导致的，先卸载再重新安装：

• 卸载命令：pip uninstall eth-brownie -y
• Windows用管理员权限打开终端、macOS/Linux执行sudo pip3 install eth-brownie重新全局安装。

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