VSCode中不能仅用files.exclude排除.venv，否则Python扩展无法扫描并注册解释器；应先手动选择解释器，再配置files.exclude隐藏目录，同时必须单独设置search.exclude以加速搜索，三者（.gitignore、files.exclude、search.exclude）需分别配置。
为什么 node_modules 和 .venv 不能混着排除
很多人一上来就往 files.exclude 里加 "**/.venv": true，结果发现 VSCode 的 Python 扩展突然不识别解释器了，调试、补全全挂。根本原因是：VSCode 的 Python 扩展在启动时会主动扫描项目目录下的 .venv（或 venv）来自动注册解释器，如果这个目录被 files.exclude 隐藏，它就“看不见”虚拟环境，也就不会加载对应依赖的类型信息和包索引。
files.exclude 可以隐藏 .venv，但得绕开 Python 扩展的扫描逻辑
想真正隐藏又不破坏功能，关键不是“能不能”，而是“什么时候隐藏”。Python 扩展只在工作区首次加载或手动触发 Python: Select Interpreter 时扫描 .venv。一旦解释器被成功选中并缓存，后续编辑、运行、调试都不再依赖文件树可见性。
- 先确保已通过命令面板正确选择了
.venv/bin/python（macOS/Linux）或.venv\Scripts\python.exe（Windows），状态栏显示路径无误 - 再编辑项目根目录下的
.vscode/settings.json，仅添加files.exclude规则：
{
"files.exclude": {
"**/.venv": true,
"**/venv": true,
"**/env": true
}
}
此时资源管理器里 .venv 消失，但 Python 功能照常工作——因为扩展已“记住”你选的解释器路径，不再实时依赖文件树。
search.exclude 必须加，且优先级高于 files.exclude
隐藏是为了浏览清爽，但搜索时更怕误扫。.venv 里几万个小文件（尤其是 pip install 后的 .dist-info 和 .egg-info）会拖慢 Ctrl+Shift+F 至少 3–5 秒。这和 files.exclude 无关，必须单独配 search.exclude：
-
search.exclude不影响任何扩展功能，只控制文本搜索范围 - 它和
files.exclude是两个独立开关，互不干扰 - 推荐合并写进同一份
.vscode/settings.json：
{
"files.exclude": {
"**/.venv": true,
"**/venv": true
},
"search.exclude": {
"**/.venv": true,
"**/venv": true,
"**/node_modules": true,
"**/dist": true
}
}
注意：search.exclude 中的 **/.venv 即使没写在 files.exclude 里也生效；反之，files.exclude 里的规则对搜索完全无效。
容易被忽略的陷阱：Git 忽略 ≠ VSCode 排除
有人把 .venv/ 加进 .gitignore 就以为 VSCode 也会自动隐藏它——不会。.gitignore 只影响 Git，VSCode 默认完全无视它，除非你显式开启 "search.useIgnoreFiles": true。但这只让搜索遵守 .gitignore，不控制文件树显示。
-
.gitignore管版本控制 -
files.exclude管侧边栏显示 -
search.exclude管全局搜索范围 - 三者必须分别配置，缺一不可
最稳妥的做法是：把 .venv/ 加进 .gitignore，再在 .vscode/settings.json 里同时写好 files.exclude 和 search.exclude ——三个地方都到位，才真正干净又可靠。
