使用os.path.join时触发Django staticfiles.W004警告的问题

遇到的警告：

?: (staticfiles.W004) STATICFILES_DIRS设置中的目录'/home/user/Desktop/Projects/project/project/project/static'不存在。

问题场景 #

• 用以下方式定义静态目录时触发警告：

BASE_DIR = Path(__file__).resolve().parent.parent
STATICFILES_DIRS = [os.path.join(BASE_DIR, '/static')]

• 直接写完整绝对路径则无异常：

STATICFILES_DIRS = ['/home/user/Desktop/Projects/project/project/project/static']

问题原因 #

os.path.join的规则是：如果第二个参数以斜杠开头，会直接忽略前面的路径参数，返回第二个参数。也就是说，你写的os.path.join(BASE_DIR, '/static')实际生成的路径是/static，而不是预期的BASE_DIR/static，Django找不到这个不存在的/static目录，自然抛出警告。

解决方法 #

有两种简单的修正方式：

1. 去掉static前面的斜杠，让os.path.join正常拼接路径：

STATICFILES_DIRS = [os.path.join(BASE_DIR, 'static')]

2. 利用Django推荐的Path对象语法（更简洁）：

STATICFILES_DIRS = [BASE_DIR / 'static']

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