VS Code Find All References无法过滤.ipynb_checkpoints等已排除文件

架构老林

2026-9-26

VS Code Find All References 过滤 .ipynb_checkpoints 等无关文件的解决方案

你遇到的配置不生效问题，核心原因是Python语言服务的代码索引、引用查找功能使用独立的排除规则，不受通用的files.exclude配置控制，按照以下步骤操作即可解决：

确认你当前使用的Python语言服务（VS Code Python扩展默认使用Pylance），找到对应的排除配置项：
打开设置面板（快捷键Ctrl+,），搜索python.analysis.exclude，在该配置项中添加规则**/.ipynb_checkpoints/**，你也可以把需要过滤的其他无关目录（比如**/__pycache__/**、**/dist/**等）一并添加到这里。
如果你是通过JSON文件修改配置，可以直接在settings.json中添加如下片段：
```
{
  "python.analysis.exclude": [
    "**/.ipynb_checkpoints/**",
    "**/__pycache__/**"
  ]
}
```
注意远程SSH场景的配置生效范围：你使用远程SSH连接开发环境时，需要确保上述配置添加到「远程」标签页的设置中，而非本地设置，否则规则不会在远程开发环境生效。
配置修改完成后，按Ctrl+Shift+P调出命令面板，执行「Python: Restart Language Server」命令重启Python语言服务，重新触发代码索引，之后再使用「Find All References」功能就不会返回无关路径下的结果了。