Python本地下载文件的教程

 

在日常开发中，我们经常需要从网络上下载文件并保存到本地。Python提供了多种方式来实现这一功能。本文将介绍如何使用Python进行本地文件下载，涵盖常见的库和方法。

## 1. 使用`urllib`库下载文件

`urllib`是Python标准库中的一个模块，提供了处理URL的基本功能。我们可以使用`urllib.request`模块来下载文件。

### 示例代码

```python
import urllib.request

def download_file(url, save_path):
    # 使用urllib.request.urlretrieve下载文件
    urllib.request.urlretrieve(url, save_path)
    print(f"文件已下载到: {save_path}")

# 示例：下载一个图片文件
url = "https://example.com/sample-image.jpg"
save_path = "sample-image.jpg"
download_file(url, save_path)
```

### 解释
- `urllib.request.urlretrieve(url, save_path)`：该方法直接从指定的URL下载文件，并将其保存到本地路径`save_path`。
- `url`：文件的URL地址。
- `save_path`：文件保存的本地路径。

## 2. 使用`requests`库下载文件

`requests`是一个流行的第三方库，用于发送HTTP请求。它比`urllib`更易于使用，并且功能更强大。

### 安装`requests`

如果你还没有安装`requests`库，可以使用以下命令进行安装：

```bash
pip install requests
```

### 示例代码

```python
import requests

def download_file(url, save_path):
    # 发送HTTP GET请求
    response = requests.get(url)
    # 检查请求是否成功
    if response.status_code == 200:
        # 将内容写入文件
        with open(save_path, 'wb') as file:
            file.write(response.content)
        print(f"文件已下载到: {save_path}")
    else:
        print(f"下载失败，状态码: {response.status_code}")

# 示例：下载一个PDF文件
url = "https://example.com/sample-document.pdf"
save_path = "sample-document.pdf"
download_file(url, save_path)
```

### 解释
- `requests.get(url)`：发送一个HTTP GET请求到指定的URL。
- `response.status_code`：检查请求是否成功（状态码200表示成功）。
- `response.content`：获取文件的二进制内容。
- `open(save_path, 'wb')`：以二进制写入模式打开文件，并将内容写入。

## 3. 使用`wget`库下载文件

`wget`是另一个常用的下载工具，Python中也有对应的`wget`库，使用起来非常简单。

### 安装`wget`

你可以使用以下命令安装`wget`库：

```bash
pip install wget
```

### 示例代码

```python
import wget

def download_file(url, save_path):
    # 使用wget.download下载文件
    wget.download(url, save_path)
    print(f"\n文件已下载到: {save_path}")

# 示例：下载一个ZIP文件
url = "https://example.com/sample-archive.zip"
save_path = "sample-archive.zip"
download_file(url, save_path)
```

### 解释
- `wget.download(url, save_path)`：直接从URL下载文件并保存到指定路径。

## 4. 处理大文件下载

对于大文件，我们可以使用流式下载，避免一次性将整个文件加载到内存中。

### 示例代码

```python
import requests

def download_large_file(url, save_path):
    # 发送HTTP GET请求，设置stream=True以流式下载
    with requests.get(url, stream=True) as response:
        response.raise_for_status()  # 检查请求是否成功
        with open(save_path, 'wb') as file:
            # 分块写入文件
            for chunk in response.iter_content(chunk_size=8192):
                file.write(chunk)
    print(f"文件已下载到: {save_path}")

# 示例：下载一个大文件
url = "https://example.com/large-file.zip"
save_path = "large-file.zip"
download_large_file(url, save_path)
```

### 解释
- `stream=True`：启用流式下载，避免一次性加载整个文件。
- `response.iter_content(chunk_size=8192)`：分块读取文件内容，每次读取8192字节。
- `file.write(chunk)`：将每个块写入文件。

## 5. 总结

本文介绍了四种常见的Python本地下载文件的方法：
1. 使用`urllib`库的`urlretrieve`方法。
2. 使用`requests`库发送HTTP请求并保存文件。
3. 使用`wget`库进行简单下载。
4. 使用流式下载处理大文件。

根据你的需求选择合适的方法，可以轻松实现文件的本地下载。希望这篇教程对你有所帮助！