[Python] Pylance extension in VSCode where type hints for Scrapy are not working properly

`### System Information:

Key Value
OS Fedora
VSCode Version 1.100.2 848b80aeb52026648a8ff9f7c45a9b0a80641e2e x64
Scrapy Version 2.13.1
Python Tool uv 0.7.5
Python Version 3.13.3
Pylance Version 2025.5.1

When Pylance is enabled, I get no type hints for Scrapy, although built-in Python types work fine.

When I disable Pylance, Scrapy hints return, but basic Python type hints disappear completely (for example, even loop auto-completion stops working).

I don’t know what else to do...

This is the translated content I obtained using a translation tool, which may contain some ambiguities. Please find the original Chinese version below.

我在使用 VSCode 的 Pylance 扩展时遇到了一个问题：Scrapy 的类型提示（type hints）无法正常工作。

As a lazy but quality-conscious developer, I need to have both:

• Must continue using VSCode (no IDE switch)
• Need a permanent, user-level configuration solution
• Need full type hints for both Scrapy and standard Python

The problem seems related to Pylance’s type inference system not recognizing Scrapy’s type definitions.

Solutions I’ve tried:


Documentation reference:
https://learnscript.net/zh/python/development-tools/vscode/pylance/#set-extra-python-module-paths

My settings.json:

{
"python.analysis.autoSearchPaths": true,
"python.analysis.extraPaths": [
"${workspaceFolder}/.venv/lib/python3.13/site-packages/scrapy",
"${workspaceFolder}/.venv/lib64/python3.13/site-packages/scrapy",
"${workspaceFolder}/.venv/lib64/python3.13/site-packages/scrapy-2.13.1.dist-info",
"${workspaceFolder}/.venv/lib/python3.13/site-packages/scrapy-2.13.1.dist-info"
]
}


With this configuration, basic Python hints work, but Scrapy hints still don't.

Essentially, it's an issue where the Pylance plugin cannot correctly resolve the types of third-party libraries.

I know that Scrapy doesn't have a typeshed, but I'm still able to get type hints using the Ctrl+Space shortcut after disabling Pylance.

I'm not quite sure why this happens.

Continue reading...