如何配置Jest路径解决Travis CI关联coveralls.io覆盖率0%问题

核心问题定位 #

当前Jest生成的lcov.info文件中，标记源码位置的SF字段为带多级上级目录前缀的非标准路径，不符合coveralls.io要求的「与Git仓库文件路径完全一致的项目相对路径」格式，导致上报模块解析失败，最终提交的source_files字段为空，平台无有效覆盖率数据可展示。

具体调整方案 #

1. 从Jest配置层修正路径生成规则 #

修改项目内的Jest配置（可在package.json的jest配置段、或独立的jest.config.js文件中调整），补充以下配置项，强制Jest生成符合标准的lcov格式报告：

module.exports = {
  // 保留项目原有Jest配置不变
  rootDir: '.', // 明确指定项目根目录为路径计算基准
  coverageDirectory: 'coverage',
  coverageReporters: ['lcov'],
  collectCoverageFrom: [
    "generators/**/*.js",
    "!**/node_modules/**"
  ]
}

配置完成后，本地执行jest --coverage，打开./coverage/lcov.info检查所有SF行的内容，确认路径为generators/app/index.js这类无多余目录前缀的相对路径即可。

2. 在CI流程中增加lcov文件预处理步骤 #

如果不需要改动Jest核心配置，可在Travis CI的执行链路中，在覆盖率文件生成完成、调用coveralls上报前，增加批量路径修正命令，直接修改lcov文件内容。
调整.travis.yml配置如下：

script:
  - jest --coverage
  # 批量替换lcov.info内的绝对路径前缀
  # 匹配所有带Travis构建目录前缀的SF行，截掉多余前缀，保留从项目根目录开始的相对路径
  - sed -i "s|SF:.*${TRAVIS_BUILD_DIR}/|SF:|g" ./coverage/lcov.info

after_success:
  - coveralls

落地校验注意事项 #

• 本地验证时，可手动生成lcov文件后逐行检查SF字段格式，只要路径和Git仓库内的文件相对路径完全匹配，即可被coveralls正常解析。
• 不建议在coveralls侧配置额外的路径映射规则，当SF字段带../../home/这类多级上级目录前缀时，内置映射逻辑无法精准匹配对应源码行。
• 本地测试上报链路时，可直接使用预处理后的lcov文件调用coveralls CLI，确认能正常匹配到源码行后，再推送分支触发CI构建。

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