http的content-text对照表

"application/json;charset=utf-8" 并不是「固定写法」------ 它是 HTTP 标准中 MIME 类型（媒体类型 / Content-Type） 的一种，第二个参数本质是给 HTTP 响应头的Content-Type字段赋值，不同的返回数据格式对应不同的 MIME 值，charset是可选的附加编码说明。

MIME 类型由「主类型 / 子类型」+ 可选的「参数（如 charset）」组成，IANA（互联网号码分配局）定义了标准 MIME 类型，开发中常用的有以下几类，结合httplib的set_content用法举例：

一、文本类（text/*）：返回纯文本、网页、脚本等

核心是「文本数据」，通常需要指定charset=utf-8避免乱码：

MIME 类型	用途	httplib 使用示例
text/plain;charset=utf-8	纯文本（如日志、简单提示）	resp.set_content("运行失败：语法错误", "text/plain;charset=utf-8");
text/html;charset=utf-8	HTML 网页（返回页面内容）	resp.set_content("<h1>编译结果</h1>", "text/html;charset=utf-8");
text/css;charset=utf-8	CSS 样式表	resp.set_content("body{color:red;}", "text/css;charset=utf-8");
text/javascript;charset=utf-8	JavaScript 脚本	resp.set_content("alert('运行完成')", "text/javascript;charset=utf-8");
text/xml;charset=utf-8	XML 格式数据	resp.set_content("<result><code>0</code></result>", "text/xml;charset=utf-8");

二、应用类（application/*）：返回结构化数据、二进制应用文件等

这是后端接口最常用的类别，核心是「非纯文本的结构化 / 二进制数据」：

MIME 类型	用途	httplib 使用示例
application/json;charset=utf-8	JSON 数据（接口最常用）	你代码中的写法，返回 JSON 字符串
application/json	JSON 数据（简写，默认 utf-8）	resp.set_content(out_json, "application/json");
application/x-www-form-urlencoded	表单提交（键值对格式）	resp.set_content("username=test&code=0", "application/x-www-form-urlencoded");
application/form-data	多部分表单（含文件上传）	极少用 set_content 返回，通常用于接收上传
application/pdf	PDF 文件（二进制）	resp.set_content(pdf_binary_data, "application/pdf");（需传入二进制字符串）
application/octet-stream	通用二进制流（如自定义文件）	resp.set_content(file_binary_data, "application/octet-stream");
application/xml;charset=utf-8	XML 数据（比 text/xml 更标准）	resp.set_content(xml_str, "application/xml;charset=utf-8");

三、图片类（image/*）：返回图片文件

无需指定 charset（图片是二进制，无编码概念）：

MIME 类型	用途	httplib 使用示例
image/jpeg	JPG/JPEG 图	resp.set_content(jpg_binary, "image/jpeg");
image/png	PNG 图	resp.set_content(png_binary, "image/png");
image/gif	GIF 图	resp.set_content(gif_binary, "image/gif");
image/webp	WebP 图	resp.set_content(webp_binary, "image/webp");

四、其他常见类型

MIME 类型	用途	说明
audio/mp3	MP3 音频	二进制音频数据，无 charset
video/mp4	MP4 视频	二进制视频数据，无 charset
multipart/form-data	多部分请求 / 响应	主要用于文件上传，极少用 set_content 返回

关键注意事项

1. charset 的使用场景：

   • 仅「文本类数据」（text/*、application/json、application/xml 等）需要加charset=utf-8，目的是告诉客户端用 UTF-8 解码文本，避免中文 / 特殊字符乱码；
   • 二进制数据（图片、音频、PDF、octet-stream 等）不能加 charset（二进制无编码概念，加了反而可能导致客户端解析错误）。

2. JSON 的 MIME 写法细节：

   • 标准写法是application/json，HTTP/1.1 协议中 JSON 的默认编码就是 UTF-8，所以application/json和application/json;charset=utf-8在绝大多数场景下等价；
   • 显式加charset=utf-8是「防御性写法」，避免部分老旧客户端 / 框架默认用其他编码（如 GBK）解析导致乱码，建议保留。

3. MIME 类型的规范性：

   • 优先使用 IANA 标准的 MIME 类型（如application/json而非自定义的application/json-utf8）；
   • 如果自定义非标准类型，客户端可能无法正确解析（比如前端拿到未知 MIME 会按纯文本处理）。

4. httplib 的兼容：

   • set_content的第二个参数可以是任意合法的字符串（只要符合 HTTP 头格式），但必须和返回的resp.body格式匹配，否则客户端解析会出错（比如返回 JSON 字符串却写text/plain，前端可能不会自动 JSON.parse）。

总结

第二个参数的核心是「告诉客户端如何解析响应正文」，不是固定值，而是根据返回数据的格式选择对应的 MIME 类型：

• 接口返回 JSON → 用application/json;charset=utf-8（推荐）或application/json；
• 返回纯文本 → 用text/plain;charset=utf-8；
• 返回图片 / 二进制文件 → 用对应 image/* 或 application/octet-stream（不加 charset）。