本文介绍如何通过 git 的 `.gitignore` 机制配合显式例外列表，安全、可追踪地禁止 `.js`/`.jsx` 文件进入 typescript 项目，兼顾强制约束与必要例外，无需自定义 eslint 规则或复杂 pre-commit 脚本。
虽然 ESLint 和 @typescript-eslint 强大且灵活，但它们本质上是代码质量检查工具，并非文件系统级准入控制器——ESLint 不处理文件是否应被纳入版本控制，它只对已加载的文件执行规则校验。因此，试图用 ESLint “禁止 .js 文件进入代码库”在设计上存在根本性错位：ESLint 不感知未被配置匹配到的文件（例如未在 files 或 overrides 中包含 .js 的配置下，.js 文件压根不会被 lint），更无法阻止其被 git add 或提交。
✅ 推荐方案：Git 层面的渐进式管控（.gitignore + 白名单例外）
这是轻量、可靠、可审计且与语言无关的工程实践：
-
全局屏蔽所有 .js/.jsx 文件
在项目根目录的 .gitignore 中添加：# Block all JS/JSX files by default *.js *.jsx !*.d.ts # Keep declaration files (if needed)
-
为确需保留的 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
-
迁移过程可视化与目标管理
每次成功将一个 .js 文件转换为 .ts 后，立即从 .gitignore 的白名单中移除对应行。这样：- .gitignore 本身成为一份实时更新的迁移进度看板；
- git status 可直观显示剩余“待迁移”文件（因被忽略而未跟踪）；
- 团队可通过 grep -n '!' .gitignore | wc -l 快速统计当前例外数，量化完成度。
⚠️ 注意事项：
方科网络ERP图文店II版为仿代码站独立研发的网络版ERP销售程序。本本版本为方科网络ERP图文店版的简化版，去除了部分不同用的功能，使得系统更加精炼实用。考虑到图文店的特殊情况，本系统并未制作出入库功能，而是将销售作为重头，使用本系统，可以有效解决大型图文店员工多，换班数量多，订单混杂不清的情况。下单、取件、结算分别记录操作人员，真正做到订单全程跟踪！无限用户级别，不同的用户级别可以设置不同的价
- 此方案不影响本地开发体验（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 迁移提供了清晰、可持续、可协作的治理路径——规则即文档，例外即任务，忽略即进度。
