如何在PyCharm社区版中为Django项目添加template文件夹

第一步：创建template文件夹 #

• 首先在Django项目的根目录（和manage.py同级的目录）新建文件夹，命名为templates，如果是仅单个APP使用的模板，也可以放在对应APP的目录下，全局通用模板统一放根目录更便于管理。
• PyCharm社区版没有自动识别Django模板目录的功能，可手动标记获得语法提示支持：右键点击刚创建的templates文件夹 -> 选择「Mark Directory as」-> 选择「Template Folder」即可。

第二步：修改settings.py配置 #

找到项目同名目录下的settings.py文件，按场景修改配置：

2.1 全局templates目录配置 #

找到TEMPLATES配置块，修改DIRS参数为根目录templates的路径：

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        # 核心修改这一行
        'DIRS': [BASE_DIR / 'templates'],
        'APP_DIRS': True,
        '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',
            ],
        },
    },
]

注意：Django 3.x及以上版本默认BASE_DIR是Path对象，直接用/拼接路径即可；如果是更低版本可以写成os.path.join(BASE_DIR, 'templates')，记得提前导入os模块。

2.2 单APP独立templates目录配置 #

如果模板仅给单个APP使用，只需确保两点即可，无需修改DIRS参数：

• 你的APP已经在INSTALLED_APPS列表中完成注册
• TEMPLATES配置块中的APP_DIRS参数保持为True

第三步：验证配置是否生效 #

在templates文件夹里新建测试模板文件，比如test.html，写入任意测试内容，然后在对应的视图函数里调用该模板：

from django.shortcuts import render

def test_view(request):
    return render(request, 'test.html')

配置好对应路由后启动项目，访问路由地址如果能正常显示test.html的内容，说明配置生效。

常见问题排查 #

• 如果出现TemplateDoesNotExist报错，优先检查DIRS的路径拼写是否正确，可在settings.py中打印BASE_DIR / 'templates'确认路径和实际创建的文件夹路径完全一致
• 全局templates文件夹不要建在项目同名的内层目录下，必须和manage.py同级才会被全局配置识别

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