# Docker pip install --no-cache-dir

官方文档：

<https://pip.pypa.io/en/stable/topics/caching/#disabling-caching>

`pip install --no-cache-dir` 是一个常用的选项，它告诉 `pip` 在安装 Python 包时 **不使用缓存**，并且 **不缓存安装包文件**（如 `.tar.gz` 或 `.whl` 文件），从而避免这些缓存文件被保留在镜像中。这个选项的使用对于减小 Docker 镜像体积非常有帮助，特别是在构建镜像时，避免将不必要的缓存文件包含在镜像层中。

### 具体解释

在默认情况下，`pip` 会将下载的包缓存到本地缓存目录中（通常是 `~/.cache/pip` 或 `/root/.cache/pip`）。这样做的目的是提高后续安装速度，因为如果你再次安装相同的包，`pip` 会直接从缓存中读取包，而不是重新下载。然而，缓存的包文件通常并不需要包含在 Docker 镜像中，这些缓存文件会导致镜像体积增大。

#### 使用 `--no-cache-dir`

当你在 Dockerfile 中执行 `pip install` 时，可以加入 `--no-cache-dir` 选项，避免缓存文件被存储在镜像中。这样可以确保只有安装后的包被保留在镜像中，而不会有任何额外的缓存文件。

**示例：**

```dockerfile
FROM python:3.9

WORKDIR /app

COPY requirements.txt .

# 安装依赖并避免缓存
RUN pip install --no-cache-dir -r requirements.txt

COPY . .

CMD ["python", "app.py"]
```

在这个例子中，`pip install --no-cache-dir` 会确保在安装依赖时不缓存任何下载的包文件，避免这些文件被包含在镜像层中，从而减小镜像的体积。

### 缓存存储的默认路径

```linux
~/.cache/pip
```

```mac
~/Library/Caches/pip
```

```windows
%LocalAppData%\pip\Cache
```

### 为什么 `--no-cache-dir` 重要？

1. **减小镜像体积：**\
   安装过程中，`pip` 下载的包会存储在缓存目录中，而这些包并不需要被包含在最终的镜像中。使用 `--no-cache-dir` 可以避免将这些缓存文件添加到镜像层中。
2. **避免不必要的文件：**\
   缓存文件并不是最终运行环境所需要的，通常只是为了加速后续的安装过程。它们会占用额外的存储空间，增加 Docker 镜像的大小，而这对最终的生产镜像是没有任何意义的。

### 总结

* **默认行为：** `pip install` 会将下载的包文件缓存到本地，以便未来复用。
* **使用 `--no-cache-dir`：** 该选项可以防止 `pip` 缓存包文件，从而避免它们被包含在 Docker 镜像层中，减小镜像体积。
* **推荐做法：** 在 Dockerfile 中使用 `pip install --no-cache-dir` 以确保生成的镜像尽可能小，避免缓存文件的冗余。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://tuonioooo-notebook.gitbook.io/docker/advanced/docker-pip-install-cache.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.