Django 的 PointField 并非内置于 django.db.models，而是 PostgreSQL 专用的地理空间字段，需通过 django.contrib.gis.db.models 导入，并依赖 GeoDjango 配置。
django 的 `pointfield` 并非内置于 `django.db.models`，而是 postgresql 专用的地理空间字段，需通过 `django.contrib.gis.db.models` 导入，并依赖 geodjango 配置。
在 Django 中使用地理空间字段（如 PointField）时，不能直接从 django.db.models 导入——这是导致 AttributeError: module 'django.db.models' has no attribute 'PointField' 的根本原因。PointField 属于 Django 的地理信息系统（GIS）扩展模块 GeoDjango，仅对支持空间数据的数据库（如 PostgreSQL + PostGIS）有效，且需显式启用和正确配置。
✅ 正确使用步骤
-
启用 GeoDjango：在 settings.py 中将 'django.contrib.gis' 添加到 INSTALLED_APPS：
INSTALLED_APPS = [ # ... 其他应用 'django.contrib.gis', 'your_app_name', # 你的应用 ] -
配置数据库为 PostGIS：确保使用 PostgreSQL 并已安装 PostGIS 扩展（可通过 CREATE EXTENSION postgis; 在数据库中启用），同时在 settings.py 中指定：
DATABASES = { 'default': { 'ENGINE': 'django.contrib.gis.db.backends.postgis', # 关键：使用 postgis 后端 'NAME': 'your_db_name', 'USER': 'your_user', 'PASSWORD': 'your_password', 'HOST': 'localhost', 'PORT': '5432', } } -
正确导入并定义模型：使用 django.contrib.gis.db.models 替代 django.db.models：
from django.contrib.gis.db import models # ✅ 正确导入 import uuid class Image(models.Model): id = models.UUIDField(primary_key=True, default=uuid.uuid4, editable=False) location = models.PointField() # 支持 SRID（如 srid=4326） date = models.DateTimeField() image = models.ImageField() def __str__(self): return f"Image at {self.location}"
⚠️ 注意事项：
- SQLite 不支持 PointField：即使初始化过 SQLite 数据库，切换至 PostGIS 前必须清空迁移记录（rm migrations/0*.py）并重新执行 makemigrations（确保 DATABASES 指向 PostGIS）。
- 依赖项检查：确保系统已安装 libspatialite-dev（Linux/macOS）或对应 GDAL/GEOS 库；Python 环境需安装 GDAL、GEOS 和 proj 绑定（推荐使用 pip install pygdal 或按 GeoDjango 官方安装指南 配置）。
- 迁移前验证：运行 python manage.py check --deploy 可提前发现 GIS 配置问题。
完成上述配置后，执行 python manage.py makemigrations 将正常生成迁移文件，后续 migrate 即可创建含 geometry 列的空间表。GeoDjango 不仅提供 PointField，还支持 LineStringField、PolygonField 及丰富的空间查询（如 __distance_lte、__within），是构建地图类应用的核心基础。
