本地执行yarn lint通过但CircleCI Lint Test运行失败

这类跨系统Lint结果不一致的问题，90%以上是以下几个原因导致，按优先级排查即可：

• 行尾符不统一
  macOS、Linux默认使用LF作为文本文件行尾，Windows默认使用CRLF，如果本地git配置了自动行尾转换、或者仓库内混杂了不同行尾格式的文件，CI拉取到的代码行尾会和本地不一致，触发linebreak-style类的Lint报错。
  修复步骤：
  1. 在项目根目录新建.gitattributes文件，强制仓库内文本文件统一使用LF行尾：

  * text=auto eol=lf
  # Windows可执行脚本保留CRLF
  *.cmd text eol=crlf
  *.bat text eol=crlf
  

  2. 本地执行命令重新规范化所有文件行尾，提交后重新触发CI：

  git add --renormalize .
  git commit -m "chore: unify line endings to LF"
  git push
  

• 依赖版本漂移
  如果lock文件（yarn.lock/package-lock.json）未提交、或者CI安装依赖时没有加锁版本参数，会导致CI侧安装的lint工具、规则包版本和本地不一致，最终校验结果不同。
  修复步骤：
  1. 确认项目的lock文件已提交到Git仓库，未被.gitignore规则忽略
  2. 修改CircleCI配置中的依赖安装命令，使用yarn install --frozen-lockfile，强制CI完全按照lock文件安装对应版本依赖，禁止版本漂移
  3. 本地删除node_modules目录和缓存，重新执行yarn install后跑一次yarn lint，确认本地结果和CI对齐
• 文件路径大小写不匹配
  macOS默认文件系统大小写不敏感，Linux文件系统严格区分大小写。如果代码中import路径、资源引用路径的大小写和实际文件名不一致（比如实际文件为UserTable.tsx，代码写为import UserTable from './userTable'），本地不会触发报错，但到Linux环境会被Lint的import校验规则直接拦截。
  修复方式：全局排查所有文件引用路径，确保路径、文件名的大小写和实际文件完全一致，修正后提交即可。
• 环境差异触发不同规则逻辑
  部分自定义Lint规则会读取运行环境的OS参数、环境变量走不同校验逻辑，这种情况直接查看CircleCI任务日志里的具体报错条目，定位到对应文件、行号和规则名，本地针对性修正即可。

本地快速复现技巧：使用和CircleCI运行版本一致的Linux Docker镜像，挂载本地项目代码后在容器内执行yarn install && yarn lint，可以完全复现CI侧的报错，无需反复推送代码调试。

内容的提问来源于stack exchange，提问作者AAMCODE