Windows下Yarn PNP与Testcafe共存时引发盘符大小写不匹配问题

问题背景 #

在.yarnrc中配置启用Yarn PNP严格模式后：

nodeLinker: "pnp"
pnpMode: "strict"

运行TestCafe测试时触发TypeScript编译失败错误（错误码E1035），核心表现为路径大小写不一致：

C:/testcafe/test.ts (13, 17): File name
'C:/testcafe/.yarn/cache/testcafe-npm-2.0.0-395078fea1-9192f88fb7.zip/node_modules/testcafe/ts-defs/index.d.ts'
differs from already included file name
'c:/testcafe/.yarn/cache/testcafe-npm-2.0.0-395078fea1-9192f88fb7.zip/node_modules/testcafe/ts-defs/index.d.ts' only in casing.

注意：设置forceConsistentCasingInFileNames: false无法解决该问题，因为此选项仅管控文件名的大小写一致性，而本次问题出在路径根目录的大小写差异（C:/ vs c:/）。

可行解决方案 #

方案1：降低Yarn PNP的严格性（快速临时解决） #

在.yarnrc.yml中添加配置，宽松处理路径大小写：

pnpFallbackMode: "loose"

此配置会让Yarn在路径匹配时忽略大小写差异，快速解决编译冲突，但会略微降低PNP的严格性。

方案2：自定义TestCafe的TypeScript编译配置 #

创建专用的tsconfig.testcafe.json，通过路径映射统一TestCafe的类型定义路径：

{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "testcafe": [".yarn/cache/testcafe-npm-2.0.0-395078fea1-9192f88fb7.zip/node_modules/testcafe/ts-defs/index.d.ts"]
    },
    "forceConsistentCasingInFileNames": true
  }
}

启动TestCafe时指定该配置文件：

testcafe chrome test.ts --ts-config tsconfig.testcafe.json

方案3：重置Yarn缓存（彻底解决路径大小写问题） #

删除项目根目录下的.yarn/cache文件夹，重新执行yarn install，让Yarn重新生成统一大小写的缓存路径（Windows环境下生效，因为Windows文件系统本身大小写不敏感，重新安装会统一路径格式）。

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