1. 理解Django URL路由机制
在django中，url路由通过urlpatterns列表进行定义。当一个请求到达服务器时，django会按照urlpatterns中定义的顺序匹配url模式。include()函数允许我们将url路由分发到各个应用（app）的urls.py文件中，从而实现模块化管理。
例如，在您的mysite/urls.py中：
urlpatterns = [
path('admin/', admin.site.urls),
path("polls/", include("polls.urls")), # 所有以 /polls/ 开头的请求都由 polls 应用处理
path('', ?), # 这是我们希望配置的根路径
]polls.urls文件中的path("", views.index, name="index")实际上会匹配domainname.com/polls/，而不是domainname.com/，这是因为其父路径已由mysite/urls.py中的path("polls/", include("polls.urls"))指定。
为了在根域名domainname.com/处显示自定义内容，我们需要在项目的主urls.py中直接为其定义一个路径。
2. 创建首页视图函数
首先，在您的主项目（例如mysite）的views.py文件中创建一个简单的视图函数，用于渲染首页内容。
在mysite/views.py中添加如下代码：
# mysite/views.py
from django.shortcuts import render
def homepage(request):
"""
渲染项目首页。
"""
return render(request, 'homepage.html')这个homepage函数将接收一个HTTP请求，并使用render函数加载名为homepage.html的模板文件。
3. 创建首页HTML模板
接下来，您需要创建homepage.html文件。为了保持项目结构清晰，建议在主项目目录下创建一个templates文件夹，并在其中再创建一个与项目同名的子文件夹（例如mysite），然后将homepage.html放在这里。
文件路径示例：mysite/templates/mysite/homepage.html
mysite/templates/mysite/homepage.html内容示例：
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>欢迎来到我的首页</title>
</head>
<body>
<h1>欢迎来到我的自定义首页！</h1>
<p>这是您的Django项目的根页面。</p>
<p>您可以在这里添加任何您想要展示的内容。</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/code/10198" title="视野自助系统小型企业版2.0 Build 20050310"><img
src="https://img.php.cn/upload/webcode/000/000/020/176109480315183.png" alt="视野自助系统小型企业版2.0 Build 20050310" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/code/10198" title="视野自助系统小型企业版2.0 Build 20050310">视野自助系统小型企业版2.0 Build 20050310</a>
<p>自定义设置的程度更高可以满足大部分中小型企业的建站需求，同时修正了上一版中发现的BUG，优化了核心的代码占用的服务器资源更少，执行速度比上一版更快 主要的特色功能如下： 1）特色的菜单设置功能，菜单设置分为顶部菜单和底部菜单，每一项都可以进行更名、选择是否隐 藏，排序等。 2）增加企业基本信息设置功能，输入的企业信息可以在网页底部的醒目位置看到。 3）增加了在线编辑功能，输入产品信息，企业介绍等栏</p>
</div>
<a href="/xiazai/code/10198" title="视野自助系统小型企业版2.0 Build 20050310" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div>
<nav>
<ul>
<li><a href="/polls/">前往投票应用</a></li>
<li><a href="/admin/">管理后台</a></li>
</ul>
</nav>
</body>
</html>4. 配置项目URL路由
现在，您需要更新主项目的urls.py文件（例如mysite/urls.py），将根路径''映射到刚刚创建的homepage视图函数。
修改mysite/urls.py：
# mysite/urls.py
from django.contrib import admin
from django.urls import include, path
# 导入您的主项目views文件中的homepage视图
from . import views
urlpatterns = [
path('admin/', admin.site.urls),
path("polls/", include("polls.urls")),
# 将根路径 '' 映射到 homepage 视图
path('', views.homepage, name='home'),
]注意： 确保from . import views这行能够正确导入mysite/views.py中的homepage函数。
5. 确保模板加载设置正确
为了让Django能够找到您在mysite/templates/mysite/homepage.html中创建的模板文件，您需要检查并配置主项目的settings.py文件中的TEMPLATES设置。
在mysite/settings.py中，找到TEMPLATES配置，并确保DIRS列表包含了您的项目级模板目录。
# mysite/settings.py
import os
from pathlib import Path
BASE_DIR = Path(__file__).resolve().parent.parent
TEMPLATES = [
{
'BACKEND': 'django.template.backends.django.DjangoTemplates',
# 确保这一行存在，它告诉Django在BASE_DIR/templates中查找模板
'DIRS': [os.path.join(BASE_DIR, 'templates')],
'APP_DIRS': True, # 允许Django在每个应用的templates目录下查找模板
'OPTIONS': {
'context_processors': [
'django.template.context_processors.debug',
'django.template.context_processors.request',
'django.contrib.auth.context_processors.auth',
'django.contrib.messages.context_processors.messages',
],
},
},
]'DIRS': [os.path.join(BASE_DIR, 'templates')]这一行是关键，它告诉Django在项目的根目录下寻找一个名为templates的文件夹，作为全局模板存放位置。
6. 最终项目结构概览
完成上述步骤后，您的项目结构应大致如下：
mysite/ ├── manage.py ├── mysite/ │ ├── __init__.py │ ├── asgi.py │ ├── settings.py │ ├── urls.py # 主项目URL配置 │ ├── views.py # 主项目视图文件，包含 homepage 视图 │ └── wsgi.py │ └── templates/ # 主项目模板目录 │ └── mysite/ │ └── homepage.html # 您的自定义首页模板 ├── polls/ # 投票应用 │ ├── migrations/ │ ├── templates/ │ │ └── polls/ │ │ └── index.html # 投票应用的首页模板 │ ├── __init__.py │ ├── admin.py │ ├── apps.py │ ├── models.py │ ├── tests.py │ ├── urls.py │ └── views.py └── db.sqlite3
7. 注意事项与最佳实践
-
关于独立App作为首页： 许多Django项目确实会创建一个名为home、core或frontpage的独立App来处理首页及其他通用页面（如关于我们、联系我们等）。这是一种非常好的实践，因为它遵循了Django的“可插拔应用”原则，提高了代码的模块化和可维护性。即使只有一个页面，将其放在一个App中也使得未来扩展变得更容易，例如添加静态页面、SEO优化等。
- 如果选择这种方式，您会在mysite/urls.py中这样配置：path('', include('home.urls'))。
- 在home/urls.py中：path('', views.home_view, name='home')。
- 在这种情况下，homeApp的urls.py可以设置app_name = "home"，但由于它是根路径，通常并不强制要求命名空间，因为通常不会通过{% url 'home:home' %}来引用它。
命名空间（app_name）： 当您在mysite/urls.py中直接定义path('', views.homepage, name='home')时，这个home的URL名称是全局可见的，不需要命名空间。命名空间主要用于区分不同App中可能重名的URL名称，例如polls:index和blog:index。对于直接映射到根路径的视图，通常不需要为其所在的文件设置app_name。
静态文件： 如果您的首页需要加载CSS、JavaScript或图片等静态文件，请确保您的settings.py中配置了STATIC_URL和STATICFILES_DIRS，并在模板中使用{% load static %}和{% static 'path/to/your/file' %}来引用。
通过遵循上述步骤和建议，您将能够成功地在Django项目的根域名下设置一个自定义的首页。
