# 使用 pnpm（推荐）
pnpm add -D lint-staged husky
 
# 使用 npm
npm install -D lint-staged husky
 
# 使用 yarn
yarn add -D lint-staged husky

# 初始化 husky，创建 .husky/ 目录
npx husky init
 
# 这会自动创建 .husky/pre-commit 文件并添加 `npx lint-staged` 命令

{
  "lint-staged": {
    "*.js": "eslint --fix",
    "*.{js,ts,tsx}": "prettier --write"
  }
}

export default {
  '*.js': ['eslint --fix'],
  '*.{js,ts,tsx}': ['prettier --write'],
  '*.{css,scss}': ['stylelint --fix'],
}

# 1. 安装依赖
pnpm add -D lint-staged husky eslint prettier
 
# 2. 初始化 husky
npx husky init
 
# 3. 确认 .husky/pre-commit 文件内容包含：
# npx lint-staged
 
# 4. 添加 lint-staged 配置到 package.json
# 5. 暂存文件并提交
git add .
git commit -m "feat: 初始化项目"
# → 此时 lint-staged 自动对暂存文件执行 eslint --fix 和 prettier --write

export default {
  '*.js': 'eslint --fix',
  '*.{ts,tsx}': ['eslint --fix', 'prettier --write'],
  '*.md': 'markdownlint',
  'src/**/*.{css,scss}': 'stylelint --fix',
}

export default {
  '*.js': (files) => {
    // 根据文件数量选择不同的检查方式
    if (files.length > 100) {
      return ['eslint --fix --quiet']
    }
    return [`eslint --fix ${files.join(' ')}`]
  },
}

{
  "*.js": ["eslint --fix", "prettier --write"]
}

npx lint-staged --debug

export default {
  '*': 'prettier --write',
}
// 配合 --concurrent 参数控制并发

npx lint-staged --concurrent 5

// .lintstagedrc.js
export default {
  '*.{js,ts,tsx}': ['eslint --fix', 'prettier --write'],
}

export default {
  '*.js': ['eslint --fix --quiet'],  // --quiet 减少输出干扰
}

// 根目录 .lintstagedrc.js
export default {
  'packages/**/*.{js,ts}': ['pnpm --filter ./packages/* exec eslint --fix'],
}

export default {
  '*.{js,ts,tsx}': ['eslint --fix', 'prettier --write'],
  '*.{css,scss,less}': ['stylelint --fix', 'prettier --write'],
  '*.md': ['markdownlint', 'prettier --write'],
  '*.{json,yaml,yml}': ['prettier --write'],
}

export default {
  '*.{js,ts}': [
    'eslint --fix --max-warnings=0',
    'prettier --write',
  ],
}

export default {
  '*': ['npx gitleaks protect --staged --verbose'],
}

# 目录结构
├── .husky/
│   ├── pre-commit       # 内容: npx lint-staged
│   └── commit-msg       # 内容: npx commitlint --edit "$1"
├── package.json
└── .lintstagedrc.js

#!/usr/bin/env sh
. "$(dirname -- "$0")/_/husky.sh"
 
npx lint-staged

# 启用详细日志
npx lint-staged --debug
 
# 查看匹配的文件（不执行命令）
npx lint-staged --diff
 
# 使用相对路径调试
npx lint-staged --relative

export default {
  'packages/**/*.{js,ts,tsx}': (files) => {
    // 按包分组执行，避免重复初始化
    const packages = new Set(
      files.map(f => f.match(/^packages\/([^/]+)/)?.[1]).filter(Boolean)
    )
    const commands = []
    for (const pkg of packages) {
      commands.push(`pnpm --filter ./${pkg} exec eslint --fix`)
    }
    return commands
  },
}

# 使用 Biome 替代 ESLint + Prettier（15x 更快）
{
  '*.{js,ts,tsx}': 'biome check --apply'
}
 
# 使用 --quiet 减少输出
{
  '*.js': 'eslint --fix --quiet'
}

// ✅ 推荐：简洁清晰
export default {
  '*.{js,ts,tsx}': ['eslint --fix', 'prettier --write'],
  '*.{css,scss}': ['stylelint --fix', 'prettier --write'],
}
 
// ❌ 避免：过于复杂的逻辑
export default {
  '*': (files) => {
    // 数百行复杂逻辑...
  }
}

export default {
  // ✅ 自动修复 + 格式化
  '*.{js,ts}': ['eslint --fix', 'prettier --write'],
 
  // ❌ 只检查不修复，发现问题后提交被拒，开发者还得手动修
  '*.{js,ts}': ['eslint'],
}

export default {
  // ✅ 先 eslint 修复，再 prettier 格式化
  '*.js': ['eslint --fix', 'prettier --write'],
 
  // ❌ 顺序反了，eslint 修复可能会破坏 prettier 格式
  '*.js': ['prettier --write', 'eslint --fix'],
}

#!/usr/bin/env sh
. "$(dirname -- "$0")/_/husky.sh"
 
npx commitlint --edit "$1"

export default {
  // 使用函数式任务处理需要特殊逻辑的场景
  '*.js': (files) => {
    // 排除测试文件
    const sourceFiles = files.filter(f => !f.includes('.test.'))
    return [`eslint --fix ${sourceFiles.join(' ')}`]
  },
}

export default {
  // 有 warning 也不允许提交
  '*.js': 'eslint --fix --max-warnings=0',
}

# .github/workflows/ci.yml
- name: Run lint-staged
  run: npx lint-staged --diff=origin/${{ github.base_ref }}