17370845950

本文介绍如何通过 git 的 `.gitignore` 机制配合显式例外列表，安全、可追踪地禁止 `.js`/`.jsx` 文件进入 typescript 项目，兼顾强制约束与必要例外，无需自定义 eslint 规则或复杂 pre-commit 脚本。

虽然 ESLint 和 @typescript-eslint 强大且灵活，但它们本质上是代码质量检查工具，并非文件系统级准入控制器——ESLint 不处理文件是否应被纳入版本控制，它只对已加载的文件执行规则校验。因此，试图用 ESLint “禁止 .js 文件进入代码库”在设计上存在根本性错位：ESLint 不感知未被配置匹配到的文件（例如未在 files 或 overrides 中包含 .js 的配置下，.js 文件压根不会被 lint），更无法阻止其被 git add 或提交。

✅ 推荐方案：Git 层面的渐进式管控（.gitignore + 白名单例外）
这是轻量、可靠、可审计且与语言无关的工程实践：

1. 全局屏蔽所有 .js/.jsx 文件
   在项目根目录的 .gitignore 中添加：

   # Block all JS/JSX files by default
   *.js
   *.jsx
   !*.d.ts  # Keep declaration files (if needed)

2. 为确需保留的 JS/JSX 文件添加显式例外
   在同一 .gitignore 中，按需逐行添加白名单（支持通配符和路径）：

   # Allow specific legacy or tooling files
   !src/utils/legacy-helpers.js
   !config/webpack.config.js
   !**/*.test.jsx  # e.g., allow test files during migration

3. 迁移过程可视化与目标管理
   每次成功将一个 .js 文件转换为 .ts 后，立即从 .gitignore 的白名单中移除对应行。这样：

   • .gitignore 本身成为一份实时更新的迁移进度看板；
   • git status 可直观显示剩余“待迁移”文件（因被忽略而未跟踪）；
   • 团队可通过 grep -n '!' .gitignore | wc -l 快速统计当前例外数，量化完成度。

⚠️ 注意事项：

• 此方案不影响本地开发体验（IDE 仍可编辑 .js 文件），仅阻止其被意外提交；
• 已被 Git 跟踪的 .js 文件不受新 .gitignore 影响，需先手动 git rm --cached 再提交，才能使其被忽略；
• 若需自动化检测“新增未忽略的 .js 文件”，可在 CI 中加入简单检查（如 git ls-files '*.js' '*.jsx' | grep -q '.' && echo "ERROR: JS files found" && exit 1 || true），作为双重保障；
• 避免使用 pre-commit shell 脚本拦截（如原问题中所示），因其易绕过（--no-verify）、跨平台兼容性差，且将逻辑耦合到客户端而非仓库策略。

总结而言，用 .gitignore 实现“默认拒绝 + 显式许可”模型，既符合 Git 的设计哲学，又为 TypeScript 迁移提供了清晰、可持续、可协作的治理路径——规则即文档，例外即任务，忽略即进度。