Express模块声明文件缺失及import语法错误问题求助

一、处理Could not find a declaration file for module 'express' #

这个问题是因为Node.js/TypeScript找不到Express的类型声明文件，确保安装正确的类型包：

npm install @types/express --save-dev

无需自行创建类型定义，官方维护的@types/express已经覆盖了所有核心类型。

二、处理SyntaxError: Cannot use import statement outside a module #

这个错误是因为你的文件被Node.js当作CommonJS模块处理，而import是ES模块语法，两种解决方式二选一：

• 方案1：改用CommonJS语法
  把导入语句换成require：

  const express = require('express');
  const { Request, Response } = require('express');
  

• 方案2：启用ES模块
  在项目根目录的package.json中添加：

  "type": "module"
  

  注意：启用后不能混合使用require，若要保留类型注解，建议将文件后缀改为.ts用TypeScript编译。

三、代码中的关键错误修正 #

你的代码存在逻辑和类型问题，以下是修正后的版本：

推荐：使用TypeScript（适配类型注解） #

将文件后缀改为.ts，并安装依赖：

npm install typescript @types/node --save-dev

修正后的.ts代码：

import express, { Request, Response } from 'express'; 

const dictionary = {
    "apple": "A round fruit with red or green skin and a white flesh.",
    "banana": "A long curved fruit which grows in clusters and has soft pulpy flesh.",
    "orange": "A spherical fruit with a tough bright reddish-yellow rind.",
};
  
const app = express();
app.use(express.json());
  
// 定义获取单词释义的API端点
app.get('/:word', function (req: Request, res: Response) {
  const word = req.params.word;
  const definition = dictionary[word as keyof typeof dictionary];
  if (definition) {
    res.send({ word, definition });
  } else {
    res.status(404).send({ error: '字典中未找到该单词' });
  }
});
 

app.listen(3000, () => {
  console.log("服务器在3000端口监听");
});

说明：

• 路由参数改为:word避免和变量名dictionary冲突，更语义化
• 导入的类型是大写的Request和Response（Express导出的类型为大写开头）
• 用keyof typeof dictionary确保访问的键在字典对象中存在，避免类型报错
• 增加了单词不存在时的404响应逻辑

纯JavaScript版本（去掉类型注解） #

const express = require('express');

const dictionary = {
    "apple": "A round fruit with red or green skin and a white flesh.",
    "banana": "A long curved fruit which grows in clusters and has soft pulpy flesh.",
    "orange": "A spherical fruit with a tough bright reddish-yellow rind.",
};
  
const app = express();
app.use(express.json());
  
// 定义获取单词释义的API端点
app.get('/:word', function (req, res) {
  const word = req.params.word;
  const definition = dictionary[word];
  if (definition) {
    res.send({ word, definition });
  } else {
    res.status(404).send({ error: '字典中未找到该单词' });
  }
});
 

app.listen(3000, () => {
  console.log("服务器在3000端口监听");
});

四、关于类型定义的疑问 #

不需要自行创建Express的类型定义，@types/express是社区维护的官方兼容类型包，只要正确安装并配置好TypeScript环境（若使用TS），就能直接使用所有内置类型。

内容的提问来源于stack exchange，提问作者Google Wont Hide My Name