如何让VSCode Pylance忽略特定uvloop导入的未解析警告？

以下几种方法可以让你只消除uvloop导入的警告，同时保留其他场景下的未解析导入检查：

• 单行注释抑制特定警告
  直接在import uvloop行添加Pylance识别的注释，精准忽略这一行的导入未解析警告：

import asyncio

try:
    import uvloop  # type: ignore[import]
    asyncio.set_event_loop_policy(uvloop.EventLoopPolicy())
except ImportError:
    pass

这个注释仅作用于当前行，不会影响其他代码的导入检查。

• 项目配置文件指定忽略规则
  在项目根目录创建pyrightconfig.json文件（Pylance基于Pyright引擎），配置仅忽略uvloop的导入警告：

{
  "ignore": [
    "import \"uvloop\" could not be resolved"
  ]
}

如果只想针对特定文件生效，可以用perFileConfig做更精细的控制：

{
  "perFileConfig": [
    {
      "filePatterns": ["your_script.py"],
      "ignore": ["import \"uvloop\" could not be resolved"]
    }
  ]
}

替换your_script.py为实际包含这段代码的文件名即可。

• 利用类型检查常量标记可选导入
  借助typing模块的TYPE_CHECKING常量，让类型检查器识别这是一个可选导入，同时不影响运行逻辑：

import asyncio
from typing import TYPE_CHECKING

if TYPE_CHECKING:
    import uvloop

try:
    import uvloop
    asyncio.set_event_loop_policy(uvloop.EventLoopPolicy())
except ImportError:
    pass

TYPE_CHECKING在运行时为False，不会干扰实际的导入流程，但能让Pylance不再对uvloop的导入发出警告。

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