Cursor中Pylance无法识别Django的Linting问题求助

1. 修正DecimalField的default参数类型错误 #

你的代码中default='0.00'传递的是字符串类型，但DecimalField的default参数预期接收Decimal实例、数值类型或可自动转换的合法值，Pylance（结合django-stubs）会严格校验类型匹配。

修改方法：

• 导入Decimal类并传入字符串转Decimal的实例（推荐，避免浮点精度问题）：

from decimal import Decimal

x = models.DecimalField(max_digits=18, decimal_places=2, default=Decimal('0.00'))

• 或者直接传入浮点数值：

x = models.DecimalField(max_digits=18, decimal_places=2, default=0.00)

2. 修复python.analysis.django配置失效的问题 #

检查Python解释器关联 #

• 点击Cursor左下角的Python解释器标识，确保选中的是项目虚拟环境中的Python解释器，而非全局解释器。如果虚拟环境未显示，可手动选择项目根目录下venv/bin/python（Linux/macOS）或venv\Scripts\python.exe（Windows）。

确认django-stubs安装环境 #

• 激活项目虚拟环境，执行pip list检查是否存在django-stubs。如果没有，重新安装：

pip install django-stubs

• 确保django-stubs版本与当前Django版本兼容，比如Django 4.2对应django-stubs 4.2.x版本，版本不匹配会导致语法识别异常：

pip install django-stubs==4.2.*  # 替换为你的Django主版本号

调整settings.json配置位置与生效 #

• 确保"python.analysis.django": true配置在**项目根目录的.vscode/settings.json**中（而非用户全局settings），项目级配置优先级更高。
• 配置后按Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），选择"Reload Window"重启Cursor，让Pylance重新加载配置。

额外排查：Pylance版本问题 #

• 如果上述方法无效，尝试更新Cursor中的Pylance扩展：打开扩展面板，找到Pylance，点击"更新"按钮，新版本可能修复了Django语法识别的兼容性问题。

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