如何配置Django：仅单张图片本地加载，其余使用Google Cloud Storage？

要实现单张图片从本地加载，其余静态文件仍使用Google Cloud Storage（GCS），可以用以下几种方式：

方法一：单独配置本地静态文件URL路由 #

这种方式无需修改全局存储配置，只针对特定图片单独设置访问路径：

1. 在urls.py中添加本地静态文件的URL映射：

   from django.conf import settings
   from django.conf.urls.static import static
   
   urlpatterns = [
       # 你的其他URL配置
   ] + static('/static-local/', document_root=settings.BASE_DIR / 'static')
   

   这里/static-local/是本地静态文件的URL前缀，document_root指向你本地存放静态文件的目录（比如项目根目录下的static文件夹）。

2. 在HTML中直接使用本地URL：
   把目标图片的src改为本地前缀的路径，其他图片继续用{% static %}标签：

   <!-- 目标图片用本地路径 -->
   <img src="/static-local/img/testimg.png" alt="">
   <!-- 其他图片仍用GCS存储 -->
   <img src="{% static 'img/otherimg.png' %}" alt="">
   

方法二：自定义模板标签判断路径 #

通过自定义模板标签，根据文件路径自动选择本地或GCS的URL，保持模板写法统一：

1. 创建自定义模板标签文件：
   在你的Django应用目录下新建templatetags/custom_static.py（如果没有templatetags文件夹，先创建并添加__init__.py）：

   from django import template
   from django.templatetags.static import static as django_static
   
   register = template.Library()
   
   @register.simple_tag
   def custom_static(path):
       # 判断是否是需要本地加载的图片
       if path == 'img/testimg.png':
           return '/static-local/' + path
       # 其他文件调用原生static标签返回GCS的URL
       return django_static(path)
   

2. 在模板中使用自定义标签：
   先加载自定义标签，再替换原来的{% static %}：

   {% load custom_static %}
   
   <!-- 目标图片自动走本地路径 -->
   <img src="{% custom_static 'img/testimg.png' %}" alt="">
   <!-- 其他图片仍走GCS -->
   <img src="{% custom_static 'img/otherimg.png' %}" alt="">
   

方法三：自定义混合存储后端 #

如果希望通过collectstatic自动处理（其他文件上传GCS，目标图片留在本地），可以自定义存储后端：

1. 编写混合存储类：
   在settings.py所在目录新建storages.py：

   from storages.backends.gcloud import GoogleCloudStorage
   from django.core.files.storage import FileSystemStorage
   from django.conf import settings
   
   class MixedStaticStorage(GoogleCloudStorage):
       def _save(self, name, content):
           # 匹配目标图片，使用本地文件系统存储
           if name == 'img/testimg.png':
               fs = FileSystemStorage(location=settings.BASE_DIR / 'static')
               return fs._save(name, content)
           # 其他文件正常上传到GCS
           return super()._save(name, content)
   
       def url(self, name):
           # 目标图片返回本地URL
           if name == 'img/testimg.png':
               return '/static-local/' + name
           # 其他文件返回GCS的URL
           return super().url(name)
   

2. 修改settings.py的静态存储配置：

   # 替换原来的STATICFILES_STORAGE
   STATICFILES_STORAGE = 'yourapp.storages.MixedStaticStorage'
   

3. 配置本地URL路由：
   同方法一，在urls.py中添加/static-local/的映射。

4. 执行collectstatic：
   运行python manage.py collectstatic后，目标图片会留在本地，其他文件上传到GCS，模板中直接使用{% static %}标签即可。

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