如何解决 pip install requests[socks] zsh: no matches found: requests[socks] 问题

如何解决 pip install requests[socks] zsh: no matches found: requests[socks] 问题

在日常的 Python 开发中，requests 库是一个非常常见的工具，它使得 HTTP 请求变得简单。而 requests[socks] 这个扩展用于通过 SOCKS 代理发送 HTTP 请求。不过，很多开发者在尝试安装 requests[socks] 时会遇到如下错误：

zsh: no matches found: requests[socks]

这个问题的发生通常是因为在 Zsh shell 环境下，方括号 [] 被视为通配符，Zsh 会试图对它们进行匹配操作，而不是将其传递给 pip 命令。这会导致安装命令失败。接下来，我们将详细分析这个问题，并提供几种解决方案。

作者简介

猫头虎是谁？

大家好，我是 猫头虎，猫头虎技术团队创始人，也被大家称为猫哥。我目前是COC北京城市开发者社区主理人、COC西安城市开发者社区主理人，以及云原生开发者社区主理人，在多个技术领域如云原生、前端、后端、运维和AI都具备丰富经验。

我的博客内容涵盖广泛，主要分享技术教程、Bug解决方案、开发工具使用方法、前沿科技资讯、产品评测、产品使用体验，以及产品优缺点分析、横向对比、技术沙龙参会体验等。我的分享聚焦于云服务产品评测、AI产品对比、开发板性能测试和技术报告。

目前，我活跃在CSDN、51CTO、腾讯云、阿里云开发者社区、知乎、微信公众号、视频号、抖音、B站、小红书等平台，全网粉丝已超过30万。我所有平台的IP名称统一为猫头虎或猫头虎技术团队。

我希望通过我的分享，帮助大家更好地掌握和使用各种技术产品，提升开发效率与体验。

猫头虎分享No bug

正文

一、问题分析

Zsh Shell 的通配符问题

在 Zsh shell 中，方括号 [] 被视为文件名模式的通配符。Zsh 会尝试将方括号内的字符与文件匹配。如果没有符合条件的文件，Zsh 就会报错：“no matches found”。这就解释了为什么执行 pip install requests[socks] 时，Zsh 会报错：no matches found: requests[socks]。

Zsh 会尝试匹配 requests[socks] 中的方括号 []，但没有找到匹配的文件，因此抛出了错误。

问题的根源

• requests[socks] 是一种“额外依赖”的安装方式。requests 库支持可选的扩展模块，其中 socks 是一个允许 requests 通过 SOCKS 代理进行请求的模块。这是通过在命令中使用方括号来实现的。
• 然而，Zsh 将这些方括号视为通配符，并试图去匹配文件，从而导致 pip 无法正确解析这个命令。

二、解决方法

方法一：禁用 Zsh 的通配符扩展

最直接的方法是禁用 Zsh 的通配符扩展。可以通过临时禁用通配符扩展来避免 Zsh 尝试匹配 []。执行以下命令：

setopt no_nomatch
pip install requests[socks]

这条命令中的 setopt no_nomatch 禁用了 Zsh 的通配符匹配。如果在执行后依然遇到问题，你可以临时关闭 Zsh 的通配符匹配功能。

方法二：使用引号

另一种常见的解决办法是使用引号将 requests[socks] 包裹起来。这样，Zsh 就不会对其中的方括号进行扩展，pip 将正确接收整个字符串。执行以下命令：

pip install 'requests[socks]'

或者：

pip install "requests[socks]"

这两种方式都可以避免 Zsh 对方括号的解析。使用引号后，整个表达式 requests[socks] 将被视为一个完整的字符串，Zsh 不会进行通配符匹配。

方法三：转义方括号

另一种解决方法是使用反斜杠 \ 来转义方括号，从而避免 Zsh 将其作为通配符。执行以下命令：

pip install requests\[socks\]

通过这种方式，Zsh 会将方括号视为普通字符，而不会进行扩展，pip 将能够正确解析并安装相关依赖。

方法四：切换到 Bash 或其他 Shell

如果以上方法都不奏效，或者你习惯使用其他 shell，切换到 Bash 也是一个简单的解决方案。在 Bash 中，方括号不会被解释为通配符，可以正常使用 pip install requests[socks] 命令。只需在终端中输入以下命令即可切换到 Bash：

bash
pip install requests[socks]

然后，你可以按照常规方式安装依赖包。切换到 Bash 可能是解决此问题的最直接方式，尤其是在 Zsh 的配置无法快速调整时。

方法五：在 Zsh 中永久禁用通配符扩展

如果你长期使用 Zsh 并希望避免每次执行时都需要禁用通配符扩展，可以将 setopt no_nomatch 命令添加到你的 Zsh 配置文件（~/.zshrc）中。这将永久禁用通配符扩展，直到你手动修改该文件。

编辑你的 ~/.zshrc 文件：

nano ~/.zshrc

然后在文件末尾添加以下内容：

setopt no_nomatch

保存文件并重新加载 Zsh 配置：

source ~/.zshrc

这样，你就可以在任何时候执行 pip install requests[socks]，而不会遇到 Zsh 的通配符匹配问题。

三、其他注意事项

代理问题：在安装 requests[socks] 之前，确保你已经配置了正确的 SOCKS 代理。否则，requests 在通过代理进行请求时可能无法正常工作。你可以通过设置环境变量来配置 SOCKS 代理：

export SOCKS5_HOST='127.0.0.1'
export SOCKS5_PORT='1080'

版本问题：确保你安装的是 requests 的最新版本。可以使用以下命令来查看并升级 requests：

pip show requests
pip install --upgrade requests

四、总结

当你在 Zsh 中执行 pip install requests[socks] 时遇到 zsh: no matches found: requests[socks] 错误，问题通常是由于 Zsh 将方括号 [] 视为通配符。通过使用引号、转义符，或禁用 Zsh 的通配符扩展功能，可以解决这个问题。你也可以选择切换到 Bash shell，或者永久修改 Zsh 配置文件来避免每次执行时的麻烦。

希望通过本文的讲解，你能够顺利解决这个问题，顺利使用 requests[socks] 扩展进行代理请求。