Charles复制curl命令中文乱码如何解决？

Question

在使用 Charles 抓包并复制请求为 cURL 命令时，若原始请求中包含中文参数（如表单数据或 URL 查询参数），粘贴后常出现中文乱码问题。此问题多因字符编码转换异常导致，尤其在 macOS 或 Windows 系统剪贴板处理 UTF-8 不一致时更为明显。cURL 命令默认未显式指定编码，终端执行时可能误解析中文字符，造成服务端接收乱码。此外，Charles 导出的 cURL 未自动对中文进行 URL 编码（Percent-Encoding），进一步加剧问题。如何确保复制的 cURL 正确保留并编码中文字符，成为开发者调试接口时的常见痛点。

Answer 1

一、问题背景与现象描述

在日常接口调试过程中，开发者常使用 Charles 作为抓包工具，通过其“Copy as cURL”功能将 HTTP 请求导出为可执行的 cURL 命令。然而，当原始请求中包含中文参数（如 URL 查询字符串中的 name=张三 或表单数据中的 content=测试消息）时，复制后的 cURL 命令在粘贴至终端执行后，服务端接收到的参数往往出现乱码。

该问题在 macOS 和 Windows 系统上尤为常见，主要表现为：

• 剪贴板在跨应用传递 UTF-8 编码文本时发生字符集转换异常；
• cURL 默认未指定输入编码方式，依赖终端环境解析字符；
• Charles 导出的 cURL 未对非 ASCII 字符进行 URL Percent-Encoding 处理；
• 服务端按 UTF-8 解码时接收到的是错误字节流，导致解码失败。

二、底层机制分析：从字符编码到网络传输

要深入理解此问题，需追溯数据流转全过程：

1. 客户端发送请求：浏览器或 App 发送含中文参数的请求，默认使用 UTF-8 编码，并对 URL 中的中文做 Percent-Encoding（如“张三” → %E5%BC%A0%E4%B8%89）；
2. Charles 拦截并展示：Charles 正确解析原始字节流并以 UTF-8 显示中文；
3. “Copy as cURL”行为：Charles 将请求还原为命令行形式，但未强制对中文字段进行 URL 编码；
4. 剪贴板传输：系统剪贴板可能将 UTF-8 文本误判为本地编码（如 GBK），造成粘贴时已损坏；
5. 终端执行 cURL：shell 解析命令行参数时若环境变量 LC_CTYPE 非 UTF-8，则会错误解释多字节字符；
6. 服务端接收：收到未经正确编码的字节流，无法还原原始语义。

三、典型场景复现与验证流程

以下为一个可复现的测试案例：

步骤	操作内容	预期结果	实际表现
1	前端提交 POST 表单，参数 content=你好世界	Charles 显示明文中文	✅ 正常显示
2	右键请求 → Copy as cURL	生成包含中文的 cURL 命令	⚠️ 中文未编码
3	粘贴至 iTerm2 (macOS)	保留原字符	❌ 出现 符号
4	执行 cURL 命令	服务端收到 “你好世界”	❌ 接收乱码如 “浣犲ソ涓栫晫”

四、解决方案体系：分层应对策略

针对不同层级的问题，应采用组合式解决路径：

graph TD A[原始请求含中文] --> B(Charles 抓包) B --> C{是否自动编码?} C -->|否| D[手动预处理] D --> E[使用脚本转义中文] E --> F[粘贴前确保 UTF-8] F --> G[终端设置 LC_ALL=en_US.UTF-8] G --> H[cURL 执行成功] C -->|是| I[启用插件自动编码] I --> J[输出标准 Percent-Encoded cURL]

五、实践方案与代码示例

以下是几种有效缓解乱码问题的技术手段：

# 方案一：手动对 cURL 中文参数进行 URL 编码
curl -X POST 'https://api.example.com/submit' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'name=%E5%BC%A0%E4%B8%89&msg=%E4%BD%A0%E5%A5%BD%E4%B8%96%E7%95%8C'

方案二：使用 Python 脚本自动转换剪贴板内容：

import urllib.parse
import pyperclip

raw_curl = pyperclip.paste()
# 匹配 -d 或 query 参数中的中文
import re
def encode_chinese(match):
    s = match.group(0)
    return urllib.parse.quote(s.encode('utf-8'))

converted = re.sub(r'[\u4e00-\u9fff]+', lambda m: urllib.parse.quote(m.group(0)), raw_curl)
pyperclip.copy(converted)
print("已转义并复制回剪贴板")

方案三：配置终端环境变量防止解析偏差：

export LC_ALL=en_US.UTF-8
export LANG=en_US.UTF-8
# 加入 ~/.zshrc 或 ~/.bash_profile 持久化

六、高级技巧：定制 Charles 插件实现自动编码

利用 Charles 的开源扩展能力，可通过编写自定义插件，在“Copy as cURL”时自动完成 URL 编码：

• 监听 CopyAsCurlEvent 事件；
• 遍历请求头、查询参数、表单体；
• 对所有值执行 URLEncoder.encode(value, "UTF-8")；
• 重构 cURL 字符串并返回。

示例 Java 片段（适用于 Charles 插件开发）：

@Override
public String generateCurl(CommandContext context) {
    Request req = context.getRequest();
    StringBuilder sb = new StringBuilder("curl ");
    // ... 构建基础命令
    for (Parameter p : req.getParameters()) {
        String encodedKey = URLEncoder.encode(p.getName(), StandardCharsets.UTF_8);
        String encodedVal = URLEncoder.encode(p.getValue(), StandardCharsets.UTF_8);
        sb.append(String.format(" -d '%s=%s'", encodedKey, encodedVal));
    }
    return sb.toString();
}