NodeJS项目混用TypeScript与JavaScript遇语法错误如何解决？

当前报错的核心原因是Node.js默认不支持TypeScript的类型注解语法，同时测试环境未配置对TS文件的编译处理，直接读取TS文件时就会抛出语法错误。以下是具体解决步骤：

步骤1：安装必要依赖 #

首先安装TypeScript核心包，如果使用Jest做测试，还需安装TS兼容的测试工具及类型定义：

npm install typescript --save-dev
# 若使用Jest，额外安装
npm install ts-jest @types/jest --save-dev

步骤2：生成并配置TypeScript编译文件 #

在项目根目录执行命令生成tsconfig.json：

npx tsc --init

根据项目需求调整关键配置项（示例配置）：

{
  "compilerOptions": {
    "target": "ES6",                          // 指定编译后的JS版本，适配Node.js
    "module": "CommonJS",                     // 采用Node.js支持的CommonJS模块系统
    "outDir": "./dist",                       // 编译后的JS文件输出目录
    "rootDir": "./src",                       // 你的TS源码根目录，根据实际路径修改
    "strict": true,                           // 开启严格类型检查
    "esModuleInterop": true                   // 兼容CommonJS与ES模块的导入导出
  },
  "include": ["src/**/*"],                    // 需要编译的TS文件范围
  "exclude": ["node_modules", "__tests__"]    // 排除无需编译的目录
}

步骤3：添加编译脚本 #

在package.json中添加编译命令，方便快速将TS转为Node可识别的JS：

{
  "scripts": {
    "build": "tsc",
    "dev": "tsc --watch"  // 监听文件变化，自动重新编译
  }
}

步骤4：配置测试环境（以Jest为例） #

创建jest.config.js文件，让Jest能处理TS测试文件：

module.exports = {
  preset: 'ts-jest',
  testEnvironment: 'node',
  roots: ['<rootDir>/__tests__'],
  testMatch: ['**/*.test.ts']  // 指定测试文件后缀为.ts，更符合TS项目规范
};

同时将测试文件utilts.test.js重命名为utilts.test.ts，确保导入路径正确：

import { delimitify } from "../utilts";

describe("delimitify", () => {
  it("must return string delimited by hyphen", () => {
    const result = delimitify(['1', '2', '3'], '-');
    expect(result).toBe('1-2-3');
  });
});

步骤5：验证运行 #

1. 执行编译命令：npm run build，编译后的JS文件会输出到dist目录
2. 运行测试：npx jest，ts-jest会自动编译TS文件并执行测试用例

额外注意事项 #

• TS文件之间的导入可以省略.ts后缀，但如果直接运行编译后的JS文件，需注意路径后缀
• 如果项目采用ES模块（package.json中设置"type": "module"），需将tsconfig.json的module改为ESNext，同时调整Jest配置以兼容ES模块

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