使用pyproject.toml时pip install .[dev]在zsh下报错的问题求助

安全阿岳

2026-7-10

问题原因与解决办法

问题原因

zsh shell会将.[dev]中的方括号[]解析为文件名通配符，尝试在当前目录下匹配符合该模式的文件，由于不存在对应文件，因此抛出zsh: no matches found: .[dev]错误。而pip install .能正常执行，是因为该命令没有触发zsh的通配符解析逻辑。

解决办法

方法1：转义方括号
在方括号前添加反斜杠，阻止zsh将其解析为通配符：
```
pip install .\[dev\]
```
若需同时安装dev和test两类可选依赖：
```
pip install .\[dev,test\]
```
方法2：用引号包裹路径
将.[dev]用单引号或双引号包裹，避免zsh解析通配符：
```
pip install '.[dev]'
# 或使用双引号
pip install ".[dev]"
```
同时安装两类可选依赖的命令：
```
pip install '.[dev,test]'
```
方法3：临时切换到bash执行
通过bash直接执行命令，绕开zsh的通配符解析：
```
bash -c "pip install .[dev]"
```