JS项目中实现Git提交前自动运行单元测试，应使用husky+lint-staged组合：安装依赖、初始化husky、添加pre-commit钩子并配置lint-staged仅对暂存文件运行带--bail和--findRelatedTests的测试；轻量项目可手动编写.git/hooks/pre-commit脚本，需赋权并确保测试失败时退出码非零；测试命令须稳定可靠，推荐Jest配置--ci--bail及coverageThreshold。

在 JS 项目中实现 Git 提交前自动运行单元测试，核心是让 pre-commit 钩子触发测试命令（如 npm test 或 npx jest），且测试失败时阻断提交。关键不在于“能不能跑”，而在于“是否精准、可靠、可维护”。

用 husky + lint-staged 组合最稳妥

这是当前主流、推荐的方式，避免手动管理 .git/hooks 文件，也规避权限和路径问题：

• 安装依赖：npm install husky lint-staged --save-dev
• 初始化 husky：npx husky install（会创建 .husky/ 目录）
• 添加 pre-commit 钩子：npx husky add .husky/pre-commit "npx lint-staged"
• 在 package.json 中配置 lint-staged，例如：

  "lint-staged": {
        "*.{js,ts}": ["npm test -- --bail --findRelatedTests"]
      }

  注：--bail 表示遇到第一个失败就退出，--findRelatedTests 可选，用于只跑与暂存文件相关的测试，提速明显

直接写 .git/hooks/pre-commit 脚本（轻量项目适用）

适合不想引入额外依赖的简单项目，但需注意细节：

Wjs Uploading Video

将一个或多个视频上传至YouTube。当用户想“上传到YouTube”“发YouTube”“批量上传”“upload to YouTube”“post videos to YouTube”或发布到YouTube时使用此技能。

下载

• 文件路径必须是：.git/hooks/pre-commit（无后缀）
• 赋予执行权限：chmod +x .git/hooks/pre-commit
• 脚本内容示例（使用 Jest）：

  #!/bin/sh
  echo "Running unit tests..."
  npm test -- --bail
  if [ $? -ne 0 ]; then
    echo "❌ Unit tests failed. Commit aborted."
    exit 1
  fi

• 注意：不要用 jest . 全量扫描，应依赖 npm script 的默认行为或加 --findRelatedTests，否则每次提交都慢

确保测试命令本身可靠

自动化的前提是测试能稳定反馈结果：

• 在 package.json 的 "test" 脚本里加上 --ci 和 --bail（Jest）或 --bail=1（Vitest），防止警告掩盖错误
• 避免测试依赖本地环境（如未 mock 的 API、定时器、DOM），否则 CI 和本地 pre-commit 行为不一致
• 如果用 Jest，建议配置 collectCoverageFrom 并设 coverageThreshold，让覆盖率不足也触发失败（可选但强推荐）

调试与验证技巧

钩子不生效？多数是静默失败，不是报错：

• 手动执行钩子脚本：sh .git/hooks/pre-commit，看输出和退出码
• 检查 npm test 是否真的返回非零退出码（可在终端运行后立刻输入 echo $? 查看）
• 临时在钩子开头加 echo "pre-commit triggered"，确认是否被调用
• Windows 用户优先用 WSL 或 Git Bash 运行，避免 PowerShell 兼容性问题