如何阻止VSCode中Pylance与Pylint分析当前工作区外的Python文件？

Pylance 配置调整 #

在项目根目录的 .vscode/settings.json 中添加以下配置，明确限定分析范围为当前工作区，并排除外部文件：

{
  // 仅包含当前工作区内的Python文件
  "python.analysis.include": ["${workspaceFolder}/**/*.py"],
  // 排除工作区外的文件，可指定具体路径实现精准过滤
  "python.analysis.exclude": ["**/${workspaceFolder}/../**/*.py", "/absolute/path/to/external/files/**/*.py"],
  // 禁止监控外部文件目录，避免不必要的分析触发
  "files.watcherExclude": {
    "/absolute/path/to/external/files/**": true,
    "${workspaceFolder}/../**": true
  }
}

如果不清楚外部文件的绝对路径，可将拖拽进来的文件统一放在工作区内的临时目录（如 ./temp-external/），再针对性排除：

"python.analysis.exclude": ["${workspaceFolder}/temp-external/**/*.py"],
"files.watcherExclude": {"${workspaceFolder}/temp-external/**": true}

Pylint 配置调整 #

方式1：通过 pyproject.toml 配置 #

在项目根目录的 pyproject.toml 中添加：

[tool.pylint]
# 仅分析当前工作区文件
include = ["${workspaceFolder}/**/*.py"]
# 排除外部路径，支持相对/绝对路径
ignore-paths = ["^../", "^/absolute/path/to/external/files/"]
# 若有临时存放外部文件的目录，直接添加至排除列表
ignore-paths = ["^temp-external/"]

方式2：通过 VSCode 设置配置 #

在 .vscode/settings.json 中添加 Pylint 命令行参数：

"python.linting.pylintArgs": [
  "--include=${workspaceFolder}/**/*.py",
  "--ignore-paths=../,/absolute/path/to/external/files/,temp-external/"
]

额外注意事项 #

• 拖拽外部文件到VSCode时，不要点击弹窗中的"添加到工作区"选项，保持当前工作区范围不变。
• 确保VSCode使用的Python解释器是当前项目的虚拟环境，可通过命令面板（Ctrl+Shift+P）运行 Python: Select Interpreter 确认。
• 配置完成后，重启VSCode或运行命令面板中的 Python: Restart Language Server 使设置生效。

内容的提问来源于stack exchange，提问作者JITHIN D MATHEW