在Lint-Staged多包Monorepo中正确设置工作目录

当在Monorepo项目中使用Lint-Staged时，一个常见的问题是配置文件的路径解析问题。特别是在子包中继承根目录配置时，执行命令的工作目录可能会引发路径错误。

问题背景

在多包Monorepo结构中，通常会有一个根目录的lint-staged配置，然后各个子包继承这个基础配置。例如：

// 根目录配置
let config = {
  '*': 'knip --config knip.config.js'
}
export default config

// 子包配置
import baseConfig from '../../lint-staged.config.js'
let config = {
  ...baseConfig,
  '.js': 'npm run lint:js'
}
export default config

这种情况下，当在子包中执行knip命令时，它会尝试在子包目录下查找knip.config.js文件，而实际上这个配置文件通常位于项目根目录。

解决方案

Lint-Staged提供了--cwd参数来解决这个问题。通过在运行命令时指定当前工作目录，可以确保命令在正确的路径下执行：

npx lint-staged --cwd $PWD

这个命令会将工作目录设置为项目根目录（$PWD表示当前工作目录），从而确保所有配置文件和命令都能正确找到它们所需的资源。

实现原理

1. 工作目录概念：在Node.js中，每个进程都有一个当前工作目录的概念，影响相对路径的解析方式
2. Monorepo结构：在Monorepo中，子包通常需要访问根目录的配置文件
3. 参数覆盖：--cwd参数允许覆盖默认的工作目录设置

最佳实践

1. 在Monorepo的根目录package.json中配置lint-staged命令时，始终使用--cwd $PWD
2. 确保所有子包的配置都正确继承根配置
3. 对于需要子包特定路径的命令，可以在子包配置中使用绝对路径或相对于根目录的路径

这种方法不仅适用于knip工具，也适用于任何需要访问项目根目录配置文件的工具链集成。