如何解决使用tsc编译含axios的index.ts时出现的错误？

核心原因 #

这类问题大多是TypeScript无法正确识别axios的类型定义文件，或是全局TypeScript版本与本地项目依赖存在冲突，导致编译时类型解析失败。

解决方案 #

1. 确保类型定义文件可被识别 #

尽管axios v0.27+已内置类型定义，但可手动安装兜底，确保类型文件被正确加载：

npm install @types/axios --save-dev

2. 使用本地TypeScript编译而非全局版本 #

全局tsc可能和本地项目依赖版本不匹配，执行本地编译命令：

npx tsc index.ts

也可以在package.json中添加编译脚本：

{
  "scripts": {
    "build": "tsc index.ts"
  }
}

之后通过以下命令执行编译：

npm run build

3. 调整tsconfig.json的模块解析配置 #

在compilerOptions中明确指定Node.js风格的模块解析策略，帮助TypeScript正确找到axios的类型文件：

{
  "compilerOptions": {
    "target": "es2016",
    "module": "commonjs",
    "moduleResolution": "node",
    "esModuleInterop": true,
    "forceConsistentCasingInFileNames": true,
    "strict": true,
    "skipLibCheck": true
  }
}

修改后直接运行tsc（无需指定文件名，让编译器自动读取配置）：

tsc

4. 重置依赖安装状态 #

若存在依赖缓存或安装不完整的情况，可删除现有依赖文件后重新安装：

rm -rf node_modules package-lock.json
npm install

验证 #

完成上述操作后，执行编译命令无报错时，运行编译后的文件验证结果：

node index.js

正常情况下会打印接口返回的待办数据。

内容的提问来源于stack exchange，提问作者João Costa