使用Python上传文件可通过requests库发送POST请求，将文件以multipart/form-data格式提交。首先导入requests库，然后打开文件并构造files参数，调用requests.post()发送至目标URL，最后处理响应状态码或返回结果。支持单文件、多文件、附加字段、异步上传及认证上传等多种场景。
如果您需要通过Python程序向远程服务器提交文件，例如图片、文档或数据集，则可以通过调用支持文件上传的API接口来实现。这类操作通常使用HTTP的POST请求，并将文件作为 multipart/form-data 数据发送。以下是几种常见的实现方式：
一、使用requests库上传单个文件
requests 是 Python 中最常用的 HTTP 请求库，支持以表单形式上传文件。该方法适用于大多数 RESTful API 接口。
1、准备要上传的文件路径和目标 API 地址。
2、使用 open() 函数以二进制模式打开文件，并将其放入 files 参数中。
立即学习“Python免费学习笔记（深入）”；
3、调用 requests.post() 方法发送请求。
示例代码如下：
import requests
files = {'file': open('example.txt', 'rb')}
response = requests.post('https://httpbin.org/post', files=files)
print(response.status_code)
完成后记得关闭文件或使用 with 语句确保资源释放。
二、上传多个文件
某些API允许一次提交多个文件，此时可以构造包含多个文件项的列表并传入 files 参数。
1、构建一个包含多个元组的列表，每个元组对应一个字段名和文件对象。
2、使用 with 上下文管理器安全地打开多个文件。
3、发送 POST 请求并将文件列表传递给 files 参数。
示例代码：
import requests
with open('file1.txt', 'rb') as f1, open('file2.pdf', 'rb') as f2:
files = [('files', f1), ('files', f2)]
response = requests.post('https://httpbin.org/post', files=files)
print(response.json())
三、携带额外字段信息上传文件
很多API除了接收文件外，还需要附加参数（如认证令牌、描述文本等），可通过 data 参数一同发送。
1、将非文件字段整理为字典类型数据。
2、在发起请求时同时提供 data 和 files 参数。
3、服务器会解析 multipart 表单中的各个部分。
示例：
import requests
data = {'description': '这是一个测试文件'}
files = {'file': open('test.jpg', 'rb')}
response = requests.post('https://httpbin.org/post', data=data, files=files)
print(response.status_code)
四、使用 aiohttp 实现异步文件上传
当需要高并发上传多个文件时，可采用异步库 aiohttp 提升效率。
1、安装 aiohttp 库：pip install aiohttp。
2、导入 aiohttp 和 asyncio 模块。
3、定义异步函数，在其中创建 ClientSession 并上传文件。
示例代码：
import aiohttp
import asyncio
async def upload_file():
data = aiohttp.FormData()
data.add_field('file', open('example.txt', 'rb'),
content_type='text/plain')
async with aiohttp.ClientSession() as session:
async with session.post('https://httpbin.org/post', data=data) as resp:
print(resp.status)
asyncio.run(upload_file())
五、处理身份验证的文件上传
部分API要求在上传文件时提供身份凭证，如 Bearer Token 或 Basic Auth。
1、从API文档获取所需的认证方式。
2、在请求头中添加 Authorization 字段。
3、确保文件和认证信息一起正确发送。
示例：
import requests
headers = {'Authorization': 'Bearer your_token_here'}
files = {'file': open('data.csv', 'rb')}
response = requests.post('https://api.example.com/upload',
files=files, headers=headers)
print(response.status_code)
