如何在VS Code项目中仅屏蔽特定的「Type "IntField" is not assignable to declared type "int"」警告

我完全懂你的困扰——总不能为了这一个mongoengine字段的类型警告，就把所有赋值类型检查都关了，漏掉其他真正的代码问题对吧？下面给你几个实用的方案，都是在VS Code里就能搞定的：

方案1：单行精准忽略（适合少数几处场景） #

如果你的项目里只有零星几处这种mongoengine字段声明，直接在对应行末尾加注释就行，不会影响其他地方的警告：

from mongoengine import Document, fields, EmbeddedDocument

class AppConfiguration(EmbeddedDocument):
    max_history_length: int = fields.IntField(db_field='maxHistoryLength')  # type: ignore[assignment]

这个注释只会让当前行的赋值类型警告被忽略，其他任何地方的同类型警告都会正常显示，不会放过真正的类型错误。

方案2：全局屏蔽特定警告（适合多处出现的场景） #

如果项目里很多地方都有这种字段声明，一行一行加注释太麻烦，可以在项目根目录的.vscode/settings.json里添加配置，全局只忽略这一条特定的警告消息：

{
  "python.analysis.diagnosticSeverityOverrides": {
    "reportAssignmentType": "warning" // 保持其他赋值类型警告的级别不变
  },
  "python.analysis.ignoreDiagnostics": [
    "Type \"IntField\" is not assignable to declared type \"int\""
  ]
}

保存之后，VS Code默认的Pylance类型检查工具就会自动跳过这条特定警告，其他所有赋值类型不匹配的问题还是会正常提示你。

方案3：从根源解决（通过类型存根规范类型，适合追求规范的场景） #

如果你不想屏蔽警告，而是想让类型检查工具正确识别mongoengine字段的类型，可以自定义类型存根文件：

1. 在项目根目录创建typings/mongoengine文件夹
2. 在这个文件夹里新建fields.pyi文件，写入以下内容：

from typing import Any

class IntField:
    def __init__(self, db_field: str | None = None, **kwargs: Any) -> None: ...
    def __get__(self, instance: Any, owner: type[Any]) -> int: ...
    def __set__(self, instance: Any, value: int) -> None: ...

这个存根文件会告诉类型检查工具：IntField的实例在被访问时返回的是int类型，和你声明的类型完全匹配，自然就不会再报警告了，这也是最规范的处理方式。

备注：内容来源于stack exchange，提问作者user23534271