如何配置VS Code Pylance仅分析工作区文件，忽略打开的外部文件？

注意：此问题并非同类路径排除问题的重复，本文聚焦于扩展行为逻辑的调整，而非单纯通过路径规则过滤文件。

期望实现目标 #

希望Pylance仅以工作区模式分析项目内文件，无论编辑器中打开了什么文件。当打开外部文件（如通过Ctrl+Click查看依赖源码、Git差异对比文档）时，Pylance不要对这些文件进行分析，也不要在PROBLEMS面板中显示其错误——目前Pylance打开编辑器文件时会无条件分析，完全忽略已配置的排除规则。

当前行为 #

Pylance会分析编辑器中打开的所有Python文件，即使是：

• 项目目录外的文件（如虚拟环境venv的site-packages目录下文件）
• 虚拟文档（如Git差异对比面板、文件历史面板中的内容）
• 仅用于浏览的外部包文件

这些外部文件的诊断信息会与项目真实问题混合显示在PROBLEMS面板中，必须关闭所有外部文件才能查看项目的真实问题状态；关闭外部文件后，这些无关诊断信息才会消失，恢复正常的工作区分析结果。

已配置内容 #

.vscode/settings.json #

{
  "python.analysis.diagnosticMode": "workspace",
  // ... 其他设置
}

pyproject.toml #

[tool.pyright]
include = ["."]
exclude = [
    ".stdev/**",
    "**/__pycache__",
    ".git",
    "**/build",
    "env/**",
    "**/venv/**",
    "**/.venv/**",
    "**/.env/**",
    "**/.tox/**",
    "**/.mypy_cache/**",
    "**/.pytest_cache/**"
]
diagnosticMode = "workspace"
typeCheckingMode = "standard"
pythonVersion = "3.13"
pythonPlatform = "Windows"

核心问题 #

是否存在Pylance扩展设置或Pyright配置，能让Pylance忽略工作区include路径外的文件的诊断信息，即使这些文件在编辑器中被打开？

已尝试在pyproject.toml中配置多种include/exclude规则，但Pylance仍会分析编辑器中打开的所有Python文件，不受文件位置影响。

环境 #

• VS Code 1.105.1及Pylance扩展（ms-python.vscode-pylance 2025.8.3）
• Python 3.13
• Windows 11
• 项目使用pyproject.toml配置（偏好不使用单独的pyrightconfig.json）

目前可通过以下几种方式实现近似需求：

1. 启用Pyright的strictInclude配置 #

在pyproject.toml的[tool.pyright]区块下添加：

strictInclude = true

该配置会让Pyright严格仅分析include列表中指定的文件，完全忽略include范围外的文件——即使它们被编辑器打开。这是最贴合需求的方案，需确保include路径完全覆盖项目内需要分析的所有文件。

2. 全局配置python.analysis.exclude规则 #

在VS Code的settings.json中添加全局排除路径，强制Pylance忽略匹配文件：

"python.analysis.exclude": [
    "**/venv/**",
    "**/.venv/**",
    "**/site-packages/**",
    "**/.git/**",
    // 可根据需求补充其他外部路径
    "**/*.pyc",
    "**/__pycache__/**"
]

此配置会覆盖编辑器打开状态的优先级，直接忽略匹配路径下的所有文件的诊断分析。

3. 利用VS Code问题面板过滤功能 #

若不想修改分析规则，可直接在PROBLEMS面板中设置过滤条件：

• 点击PROBLEMS面板右上角的筛选图标
• 在「文件」筛选框中输入!**/venv/**、!**/site-packages/**等排除规则，仅显示工作区内文件的问题

内容的提问来源于stack exchange，提问作者g.pickardou