推荐使用 Django 内置的 django.contrib.sitemaps 模块生成符合协议的 XML Sitemap,通过定义 Sitemap 类、注册到 URL 路由,自动支持分页与索引文件,并需注意域名配置、字段非空及路由验证。

Django 生成 XML 格式的 Sitemap,推荐使用内置的 django.contrib.sitemaps 模块,它专为生成符合 Sitemaps 协议 的 XML 文件而设计,无需手动拼接字符串或使用第三方库。
配置 Sitemap 类
在应用目录下(如 myapp/sitemaps.py)定义一个或多个继承自 Sitemap 的类。每个类需指定数据源(items())、URL 构造逻辑(location())、更新频率(changefreq)和权重(priority)等:
# myapp/sitemaps.py
from django.contrib.sitemaps import Sitemap
from .models import Article, Category
<p>class ArticleSitemap(Sitemap):
changefreq = 'weekly'
priority = 0.8</p><pre class="brush:php;toolbar:false;">def items(self):
return Article.objects.filter(is_published=True)
def lastmod(self, obj):
return obj.updated_at
def location(self, obj):
return f'/article/{obj.slug}/'class CategorySitemap(Sitemap): changefreq = 'monthly' priority = 0.5
def items(self):
return Category.objects.all()
def location(self, obj):
return f'/category/{obj.slug}/'注册 Sitemap 到 URL 路由
在项目主 urls.py 中导入并注册 Sitemap 视图。Django 会自动渲染标准 XML 格式:
# urls.py
from django.contrib.sitemaps.views import sitemap
from myapp.sitemaps import ArticleSitemap, CategorySitemap
<p>sitemaps = {
'articles': ArticleSitemap,
'categories': CategorySitemap,
}</p><p>urlpatterns = [</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/ai/2245" title="MakeSong"><img
src="https://img.php.cn/upload/ai_manual/000/000/000/175680059054360.png" alt="MakeSong" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/ai/2245" title="MakeSong">MakeSong</a>
<p>AI音乐生成,生成高质量音乐,仅需30秒的时间</p>
</div>
<a href="/ai/2245" title="MakeSong" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div><h1>其他路由...</h1><pre class="brush:php;toolbar:false;">path('sitemap.xml', sitemap, {'sitemaps': sitemaps}, name='django.contrib.sitemaps.views.sitemap'),]
访问 /sitemap.xml 即可看到结构清晰、带命名空间的 XML 输出,包含 <urlset></urlset>、<url></url>、<loc></loc>、<lastmod></lastmod> 等标准标签。
支持分页与大型站点
当条目超过 5 万或 XML 文件过大时,Django 会自动分片(如 sitemap-articles.xml、sitemap-categories.xml),并生成索引文件 sitemap.xml。只需确保:
- 每个 Sitemap 类的
limit属性未设为过小(默认 45000) - 在
sitemaps字典中为每个类使用唯一键名 - 确认视图参数传入的是字典而非列表
部署前检查要点
确保生成的 Sitemap 可被搜索引擎正确抓取:
- 域名必须匹配
request.get_host(),生产环境设置ALLOWED_HOSTS和SECURE_PROXY_SSL_HEADER(若用 HTTPS) - 模型字段如
updated_at或slug不为空,否则location()或lastmod()可能报错 - 可通过
python manage.py show_urls(需安装django-extensions)验证路由是否生效









