pnpm两种安装Algebrite方式下Mocha测试表现差异排查

1. 让Git安装的Algebrite在Mocha测试中正常工作的方案 #

方案一：编译时输出CommonJS格式 #

既然项目用require（CommonJS）加载模块，直接把Algebrite编译成CJS格式就能从根源解决冲突：

1. 修改Algebrite仓库的tsconfig.json，调整编译配置：

{
  "compilerOptions": {
    "module": "CommonJS", // 强制编译为CJS格式
    "target": "ES6", // 兼容多数Node.js版本
    "outDir": "./dist",
    // 保留其他原有配置项
  }
}

2. 重新执行tsc编译，将编译后的代码推送到你的GitHub仓库分支。
3. 回到项目执行pnpm add github:hl037/Algebrite#SO_question重新安装，此时dist/index.js为CJS格式，用require加载不会触发语法错误，Mocha测试可正常运行。

方案二：同时输出CJS和ESM双格式（兼顾兼容性） #

如果需要兼顾其他ESM项目的使用需求，可配置TS编译双格式：

1. 在Algebrite仓库创建两个编译配置文件：
   • tsconfig.cjs.json：设置"module": "CommonJS"，"outDir": "./dist/cjs"
   • tsconfig.esm.json：设置"module": "ESNext"，"outDir": "./dist/esm"
2. 修改package.json的编译脚本，同时生成两种格式的代码：

{
  "scripts": {
    "build": "tsc -p tsconfig.cjs.json && tsc -p tsconfig.esm.json"
  }
}

3. 在package.json中指定不同模块规范的入口，不要添加"type": "module"：

{
  "main": "./dist/cjs/index.js", // 供require调用的CJS入口
  "module": "./dist/esm/index.js" // 供import调用的ESM入口
}

4. 编译推送后重新安装，项目用require会自动加载CJS入口，解决模块加载冲突。

2. pnpm ln正常、Git安装异常的原因 #

两种安装方式的模块加载逻辑存在本质差异：

• pnpm ln -g本地软链接：测试时ts-node/register会直接处理Algebrite的TS源文件，自动将其转译为符合CJS规范的代码，因此require可以正常加载，不会触发语法错误。
• Git仓库安装：pnpm会拉取仓库代码并执行编译脚本（如你配置的tsc编译），生成的dist/index.js是ESM格式（默认TS配置可能为module: ESNext），但Algebrite的package.json未设置"type": "module"，Node.js会默认将该.js文件当作CJS模块处理，此时遇到ESM的import语句就会抛出语法错误；如果添加"type": "module"，项目用require加载ESM模块又会触发ERR_REQUIRE_ESM——因为Node.js不允许用require加载标记为ESM的模块。

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