在基于 Codex 的 TypeScript 开发环境中，建立一套严谨的代码规范是保障项目可维护性和团队协作效率的关键。许多开发者在面对 ESLint、Prettier 以及 TypeScript 编译器选项时感到困惑，往往不知道如何将这些工具无缝集成到项目中。本文将提供一份实战操作攻略，帮助你在 Codex 框架下快速搭建标准化的代码检查流程。
核心依赖安装与基础配置
首先，你需要在项目根目录下初始化必要的开发依赖。通过 npm 或 yarn 安装 eslint、@typescript-eslint/parser、@typescript-eslint/eslint-plugin 以及 prettier。接着，创建 .eslintrc.js 配置文件。在这里，务必继承 @typescript-eslint/recommended 预设，并指定 parser 为 typescript-eslint/parser。这一步确保了 Linter 能够正确解析 TS 特有的语法结构，如接口定义和类型注解，从而避免误报错误。
整合 Prettier 实现格式化统一
为了保持代码风格的一致性，建议将 Prettier 与 ESLint 结合使用。安装 eslint-config-prettier 以关闭 ESLint 中与 Prettier 冲突的规则。在 ESLint 配置文件中，将 prettier/prettier 插件加入 extends 数组。这样，当开发者保存文件时，编辑器可以自动按照统一的格式规范进行美化，减少因缩进、引号或分号问题引发的代码审查争议。
集成 CI/CD 自动化检查
规范的最终落地依赖于自动化流程。在 Codex 的开发工作流中，应配置 pre-commit 钩子或在 CI 管道中加入 lint-staged 命令。这能确保只有符合规范的新增代码才能被提交。定期运行 npm run lint 命令，并对报错信息进行修复。通过这种严格的配置策略，团队能够显著降低技术债务，提升代码库的整体质量。