Yarn Berry中`yarn up`命令的glob模式使用注意事项

在Yarn Berry项目中，yarn up命令是一个强大的依赖管理工具，用于升级项目中的依赖包版本。然而，在使用glob模式匹配包名时，开发者可能会遇到一些意料之外的行为。

问题现象

当开发者尝试使用yarn up *eslint*这样的glob模式来升级所有包含"eslint"的依赖包时，系统可能会报错提示"Pattern eslint.config.mjs doesn't match any packages referenced by any workspace"。这表明Yarn不仅尝试匹配包名，还意外地匹配了项目中的文件。

问题根源

这个问题的根本原因在于shell的glob扩展行为。当在命令行中使用星号(*)这样的通配符时，shell会首先尝试在当前目录中查找匹配的文件，然后将这些匹配结果作为参数传递给命令。在上述例子中，shell会先查找当前目录下所有包含"eslint"的文件，然后将这些文件名传递给yarn up命令。

解决方案

要解决这个问题，开发者应该将glob模式用单引号包裹起来：

yarn up '*eslint*'

这样做的目的是告诉shell不要进行本地文件名的扩展，而是将整个模式字符串原样传递给Yarn命令，由Yarn自己来处理包名的模式匹配。

深入理解

Yarn Berry的设计哲学是提供精确和可预测的行为。当使用yarn up命令时：

1. 不加引号的模式会被shell首先解释为文件匹配
2. 加引号的模式会被直接传递给Yarn进行包名匹配
3. Yarn内部有自己完善的包名匹配逻辑

这种设计确保了依赖管理的精确性，但也要求开发者理解shell和Yarn之间的交互方式。

最佳实践

1. 始终对包含通配符的模式使用引号
2. 考虑使用更精确的包名匹配，如yarn up eslint或yarn up @types/eslint
3. 使用yarn why <package>命令验证包是否确实存在于项目中
4. 结合yarn info <package>查看包的可用版本信息

理解这些细微差别将帮助开发者更有效地使用Yarn Berry进行依赖管理，避免因shell扩展导致的意外行为。