日常开发调试接口时大家经常会在浏览器、Postman、Apifox 复制得到一段 curl 请求命令想要直接在 Python 中发起相同网络请求。手动把 curl 里的请求头、参数、Cookie、Body 一一翻译成 requests 代码重复繁琐极易漏参数、写错编码本文讲解 curl 转 Python 代码的实用方案、避坑要点以及自动化工具。一、常见场景为什么需要 curl 转 Python浏览器F12网络面板复制请求直接拿到curl命令测试人员提供 curl 命令复现接口问题第三方文档只提供 curl 示例没有 Python 代码调试爬虫、接口鉴权、复杂POST表单、文件上传、SSL自定义参数。直接手写 requests 代码痛点请求头数十个复制粘贴耗时区分form-data、x-www-form-urlencoded、json body 极易混淆容易丢失 Cookie、代理、超时、重定向设置curl 携带-X、-k、--proxy、--data-binary等特殊参数不好手动转换。二、方案1在线工具一键转换快速临时使用适合临时调试不需要安装任何库。推荐工具curlconverter最稳定支持输出 requests / http.client / aiohttp操作流程粘贴完整 curl 命令选择输出语言Python requests一键复制生成代码。注意在线工具局限性内网地址、携带敏感 token、Cookie 不建议粘贴到公网网站部分复杂参数自定义ssl证书、http2、unix socket转换不全长命令、特殊二进制body容易解析出错。三、方案2本地Python库解析curl生产/内网环境首选库curlconverterPython本地版可以在代码内部解析curl字符串自动生成 requests 代码离线可用杜绝敏感信息外泄。安装pipinstallcurlconverter基础示例importcurlconverter curl_cmd curl https://httpbin.org/post \ -X POST \ -H Content-Type: application/json \ -H User-Agent: python-demo \ -d {name:test,id:1001} # 转换成 requests 代码python_codecurlconverter.to_python(curl_cmd)print(python_code)输出结果importrequests headers{Content-Type:application/json,User-Agent:python-demo,}json_data{name:test,id:1001,}responserequests.post(https://httpbin.org/post,headersheaders,jsonjson_data)进阶直接执行解析后的请求参数库只能生成代码文本如果想要直接运行请求可以搭配exec仅限可控环境不要解析外部不可信curl字符串importcurlconverter curl_strcurl https://httpbin.org/getcodecurlconverter.to_python(curl_str)print(code)# 谨慎使用exec外部输入存在代码注入风险# exec(code)四、curl 常见参数对应 requests 对照表很多时候工具转换存在瑕疵掌握映射关系可以手动修正curl 参数requests 对应写法说明-X POSTrequests.post()指定请求方法-H key: valheaders{}请求头-d a1b2data{}urlencoded表单-d {k:1}json{}json请求体-F filea.jpgfiles{}multipart/form-data 文件上传-k / --insecureverifyFalse关闭SSL证书校验-x http://127.0.0.1:7890proxies{“http”: “…”}代理-b sessionxxxcookies{}Cookie-Lallow_redirectsTrue跟随重定向--max-time 10timeout10请求超时五、高频踩坑清单坑1区分 data 和 jsoncurl 中-d传入json字符串工具偶尔会错误放到data参数错误写法requests.post(url,data{a:1})正确写法requests.post(url,json{a:1})区别json会自动添加Content-Type: application/json并序列化对象。坑2form-data 表单被识别成普通data文件上传场景必须使用files参数不能用 data。坑3verifyFalse 安全风险verifyFalse关闭SSL校验会抛出警告生产环境不要随意使用如需消除警告importurllib3 urllib3.disable_warnings(urllib3.exceptions.InsecureRequestWarning)坑4curl 单引号/双引号在Windows命令行不兼容浏览器复制出来的curl一般是bash格式Windows cmd/PowerShell直接运行会报错但不影响解析库识别。坑5带有二进制、换行、特殊转义字符的body--data-binary和普通-d行为不同转换后需要核对原始报文。六、拓展curl 转异步 aiohttpcurlconverter 同样支持输出 aiohttp 代码适合高并发爬虫项目importcurlconverter curl_textcurl https://httpbin.org/get -H Token: 123456 codecurlconverter.to_aiohttp(curl_text)print(code)七、自制简易转换小工具GUI/命令行思路如果你经常处理curl可以简单封装脚本读取输入curl字符串调用 curlconverter 解析格式化代码自动复制到剪贴板搭配pyperclip实现一键复制生成结果。示例简易脚本importcurlconverterimportpyperclipdefcurl_to_requests():print(粘贴curl命令输入完成后回车两次结束)lines[]whileTrue:lineinput()ifnotline:breaklines.append(line)curl_command\n.join(lines)resultcurlconverter.to_python(curl_command)pyperclip.copy(result)print(生成代码已复制剪贴板)print(result)if__name____main__:curl_to_requests()八、总结临时快速转换使用 curlconverter 在线网站敏感接口优先本地库内网、有密钥、隐私数据使用curlconverterPython 离线库杜绝信息泄露工具生成代码后务必核对请求体类型、SSL校验、代理、重定向参数牢记data/json/files三者区别这是转换出错最高发的地方自动化脚本可以大幅提升接口调试、爬虫开发效率告别手动翻译curl。延伸思考除了转换成 requests还可以将 curl 统一解析为请求结构体封装通用请求调度器统一同步/异步请求实现接口批量压测、自动化回归测试。如果你想要我可以再补充一份可直接部署的单页面HTML转换工具前端离线curl转python或者把文章调整成适合掘金/CSDN的排版风格。
