如何在本地Docker环境的cookiecutter-django项目中添加pip包？

正确操作步骤 #

1. 添加包到对应requirements文件

   • 全局通用依赖（生产、本地环境都需要）：写入requirements/base.txt
   • 本地开发专属依赖：写入requirements/local.txt
     格式参考已有包，比如requests==2.31.0

2. 仅重建Django服务镜像
   不要直接执行docker-compose -f local.yaml build（这会遍历所有服务检查镜像更新），而是指定只构建django服务：

   docker-compose -f local.yaml build django
   

   Docker会自动检测requirements文件的变更，仅重新执行镜像构建中与依赖安装相关的步骤（依托缓存机制，构建速度很快）。

3. 重启Django容器
   镜像构建完成后，重启django容器使新依赖生效：

   docker-compose -f local.yaml up -d django
   

你之前重建所有容器的原因 #

docker-compose build不带服务名时，会默认检查所有服务的镜像构建上下文——哪怕postgres、redis这类服务的配置完全没变化，也会走一遍镜像验证流程，看起来像是“重建所有容器”。实际上大部分容器只是完成了镜像验证，并没有真的重新构建，但这一步完全没必要。指定服务名后，只会处理django相关的镜像和容器。

额外适配技巧 #

如果你的项目用了pip-tools（部分Cookiecutter-Django版本默认配置），需要先把包添加到requirements/base.in或requirements/local.in，再执行编译命令生成对应的.txt文件：

pip-compile requirements/base.in
pip-compile requirements/local.in

完成后再执行前面的镜像构建和容器重启步骤。

内容的提问来源于stack exchange，提问作者patrick__03