Node.js项目测试时模块查找失败、import语法报错及变量重声明问题的解决方案咨询

让我们一步步搞定你遇到的这几个常见配置坑：

1. 解决"Cannot find module '../src/index'"和"can't use import statement outside module"问题 #

这两个问题的核心是Mocha默认无法直接处理TypeScript文件，需要配置ts-node来编译并运行TS测试代码，同时调整测试脚本和文件的引入方式：

步骤1：安装必要的开发依赖 #

首先安装ts-node（让Mocha支持TS）以及相关类型定义：

npm install --save-dev ts-node @types/mocha @types/chai @types/chai-http

步骤2：更新package.json的test脚本 #

修改scripts中的test命令，让Mocha通过ts-node加载并执行TS文件：

"scripts": {
  "test": "mocha -r ts-node/register 'test/**/*.ts' --exit"
}

• -r ts-node/register：告诉Mocha在运行前加载ts-node，这样就能直接解析TypeScript文件
• --exit：解决测试完成后服务器进程挂起的问题（因为你的index.ts启动了HTTP服务器，会保持监听）

步骤3：调整测试文件的引入语法 #

把test/hello.ts中的require改为import，同时添加测试后关闭服务器的钩子（避免进程无法退出）：

import chai from 'chai';
import chaiHttp from 'chai-http';
import server from '../src/index';

chai.use(chaiHttp);
const expect = chai.expect; // 推荐使用expect风格的断言，更符合TS语法

describe('registration API', () => {
  describe('POST /api/register', () => { // 注意你实际用的是POST请求，标题对应更准确
    it("should return a 400 status code", (done) => {
      chai.request(server)
        .post('/api/register')
        .end((err, response) => {
          expect(response.status).to.equal(400);
          done();
        });
    });
  });

  // 所有测试完成后关闭服务器
  after((done) => {
    server.close(done);
  });
});

步骤4：优化tsconfig.json（可选但推荐） #

让TypeScript识别test目录下的文件，避免编辑器报错：

{
  "compilerOptions": {
    "target": "esnext",
    "module": "commonjs",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true,
    "typeRoots": [ "@types", "./node_modules/@types" ]
  },
  "include" : [ "src/**/*.ts", "test/**/*.ts" ], // 添加test目录到编译范围
  "exclude" : [ "node_modules" ]
}

2. 解决"Cannot redeclare block-scoped variable 'chai'"问题 #

这个问题是因为@types/chai默认会在全局作用域声明chai变量，当你用const chai = require('chai')时，就会和全局变量冲突。

解决方案： #

• 推荐方案：直接使用import语法（如上面的测试文件示例），import会创建局部变量，不会和全局声明冲突，同时更符合TypeScript的编码习惯。
• 如果坚持用require：可以通过类型断言来避免冲突：

  const chai = require('chai') as typeof import('chai');
  

额外的小提示 #

你的src/index.ts中PORT变量未定义，需要先声明才能正常运行：

import express from 'express'; // 假设你使用Express框架，记得安装express和@types/express
const app = express();
const PORT = 3000;

export default app.listen(PORT, () => { 
  console.log(`Server is listening on port ${PORT}`);
});

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