在lint-staged多包monorepo中正确配置工作目录

问题背景

在大型前端项目中，使用monorepo架构管理多个子包已成为常见做法。lint-staged作为Git钩子工具，能够帮助开发者在提交代码前自动运行lint检查。但在monorepo环境下，特别是当子包需要继承根目录配置时，会遇到工作目录(working directory)不匹配的问题。

典型场景分析

假设我们有一个monorepo项目结构如下：

/
  lint-staged.config.js
  knip.config.js
  packages/
    module-a/
      lint-staged.config.js

根目录的lint-staged配置包含了对所有文件的检查命令：

// 根目录lint-staged.config.js
export default {
  '*': 'knip --config knip.config.js'
}

子包module-a希望继承根配置并添加自己的规则：

// packages/module-a/lint-staged.config.js
import baseConfig from '../../lint-staged.config.js'

export default {
  ...baseConfig,
  '.js': 'npm run lint:js'
}

问题本质

当在子包中执行lint-staged时，默认的工作目录(pwd)是子包目录(packages/module-a)，而knip命令需要访问根目录下的knip.config.js配置文件。这会导致命令执行失败，因为相对路径解析不正确。

解决方案

lint-staged提供了--cwd参数，可以显式指定工作目录。在monorepo场景下，我们需要确保所有命令都在项目根目录下执行：

npx lint-staged --cwd $PWD

这个解决方案的关键点：

1. --cwd参数强制指定工作目录
2. $PWD环境变量代表当前工作目录的绝对路径
3. 确保所有命令都基于项目根目录执行

最佳实践建议

1. 统一工作目录：在monorepo中，建议所有lint-staged命令都在根目录下执行，保持一致性

2. 配置继承策略：子包配置可以继承根配置，但要考虑路径解析问题

3. 环境变量使用：利用$PWD等环境变量确保路径正确性

4. Git钩子配置：在.husky或类似的Git钩子管理工具中统一设置工作目录

深入理解

理解这个问题需要掌握几个关键概念：

1. 工作目录：进程执行时的当前目录，影响相对路径的解析
2. 命令解析：shell命令中的相对路径是基于工作目录而非脚本位置的
3. monorepo架构：多包管理带来的路径复杂性需要特别处理

通过正确设置工作目录，可以确保lint-staged在多包monorepo中稳定运行，既能够复用根配置，又能在各子包中添加特定规则，实现灵活而统一的代码质量控制。