在 Node.js 中设置响应的 MIME 类型是为了让浏览器正确解析服务器返回的内容,比如 HTML、CSS、图片、JSON 等。我们通常通过设置响应头中的 Content-Type
字段来完成。
✅ 一、什么是 MIME 类型(Content-Type)?
MIME(Multipurpose Internet Mail Extensions)类型用于告诉浏览器或客户端:返回的数据是什么类型的内容。
例如:
text/html
:HTML 文件application/json
:JSON 数据text/css
:CSS 样式表image/png
:PNG 图片
✅ 二、手动设置 MIME 类型示例
const http = require('http');
const fs = require('fs');
const path = require('path');// 常见扩展名与 MIME 类型的映射表
const mimeTypes = {'.html': 'text/html','.css': 'text/css','.js': 'application/javascript','.json': 'application/json','.png': 'image/png','.jpg': 'image/jpeg','.gif': 'image/gif','.svg': 'image/svg+xml','.ico': 'image/x-icon','.txt': 'text/plain',
};const server = http.createServer((req, res) => {let filePath = '.' + (req.url === '/' ? '/index.html' : req.url);let ext = path.extname(filePath);// 默认 MIME 类型let contentType = mimeTypes[ext] || 'application/octet-stream';fs.readFile(filePath, (err, data) => {if (err) {res.writeHead(404, { 'Content-Type': 'text/plain' });return res.end('404 Not Found');}res.writeHead(200, { 'Content-Type': contentType });res.end(data);});
});server.listen(3000, () => {console.log('Server running on http://localhost:3000');
});
✅ 三、使用第三方模块 mime
如果你不想维护 MIME 映射表,可以使用官方推荐的 mime
模块。
安装:
npm install mime
使用:
const mime = require('mime');
const filePath = 'public/style.css';
const contentType = mime.getType(filePath); // 返回 'text/css'
✅ 常用 MIME 类型一览
扩展名 | MIME 类型 |
---|---|
.html | text/html |
.css | text/css |
.js | application/javascript |
.json | application/json |
.png | image/png |
.jpg | image/jpeg |
.gif | image/gif |
.svg | image/svg+xml |
.txt | text/plain |
.pdf | application/pdf |
✅ 四、注意事项
Content-Type
是告诉浏览器怎么处理数据的关键;- MIME 类型必须与实际资源类型匹配,否则浏览器可能拒绝渲染或报错;
- 若未设置
Content-Type
,浏览器可能会猜测类型,但这不安全; - 返回 JSON 时推荐:
res.writeHead(200, { 'Content-Type': 'application/json' }); res.end(JSON.stringify({ message: 'hello' }));