安装eth-brownie时pipx报错「不被识别为cmdlet名称」如何解决

问题原因 #

该报错是pipx可执行文件的路径没有被正确加载到当前终端的环境变量中导致的，虽然执行了python3 -m pipx ensurepath命令，依然有几种常见场景会导致路径不生效：

• 使用Windows系统的PowerShell/CMD时，ensurepath添加的是用户级环境变量，仅重启VS Code终端没有触发环境变量全局刷新，需要完全退出VS Code甚至重启系统才会生效
• Linux/macOS下使用了非默认shell（比如zsh、fish），ensurepath默认只把路径写入了.bashrc配置文件，没有写入当前使用的shell对应的配置文件
• 安装pipx时--user参数对应的用户包路径没有被正确包含在系统全局环境变量中

解决方案 #

临时可用方案（无需调整环境变量，可立刻执行安装） #

直接用Python模块调用的方式执行pipx命令，跳过环境变量检查：

python3 -m pipx install eth-brownie

如果需要长期直接使用pipx命令，根据所用操作系统选择对应方案： #

Windows系统配置方案 #

1. 完全关闭所有VS Code窗口后重新打开，再尝试执行pipx命令
2. 如果仍然报错，打开系统环境变量编辑器，检查用户变量的Path中是否存在以下两个路径，缺失则手动添加：

   %USERPROFILE%\AppData\Roaming\Python\Python<你的Python版本号>\Scripts
   %USERPROFILE%\.local\bin
   

3. 路径添加完成后重启VS Code即可正常调用pipx

macOS/Linux系统配置方案 #

1. 先确认当前使用的shell类型：

   echo $SHELL
   

2. 若输出为/bin/zsh，执行以下命令手动将路径写入zsh配置并刷新：

   echo "export PATH=\"$HOME/.local/bin:\$PATH\"" >> ~/.zshrc
   source ~/.zshrc
   

3. 若输出为/bin/bash，执行以下命令：

   echo "export PATH=\"$HOME/.local/bin:\$PATH\"" >> ~/.bashrc
   source ~/.bashrc
   

4. 若使用其他类型的shell，对应将上述路径写入自身的配置文件刷新后即可正常使用pipx命令

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