VS Code资源管理器中.venv文件夹不显示问题排查求助

日常用Python做应用开发，最近尝试UV框架时发现，通过该框架创建的.venv文件夹确实存在，但在VS Code的资源管理器树视图里看不到。

用户设置 #

{
    // General settings
    "security.workspace.trust.untrustedFiles": "newWindow",
    "window.zoomLevel": 1,
    "window.commandCenter": false,
    "files.exclude": {
        ".git": true,
        "**/.git": false
    },
    "extensions.autoUpdate": "onlyEnabledExtensions",
    // Git settings
    "git.autofetch": true,
    "git.confirmSync": false,
    "git.enableSmartCommit": true,
    "git.showActionButton": {
        "commit": false,
        "publish": false,
        "sync": false
    },
    "github.copilot.enable": {
        "*": true,
        "plaintext": false,
        "scminput": false,
        "yaml": false
    },
    // Explorer settings
    "explorer.excludeGitIgnore": true,
    "explorer.autoReveal": true,
    "explorer.confirmDelete": false,
    "explorer.confirmDragAndDrop": false,
    // Workbench settings
    "workbench.colorTheme": "Default Light+",
    "workbench.editor.tabSizing": "shrink",
    "workbench.settings.editor": "json",
    // Editor settings
    "ruff.importStrategy": "useBundled",
    "editor.defaultFormatter": "charliermarsh.ruff",
    "editor.formatOnPaste": true,
    "editor.formatOnSave": true,
    "editor.formatOnSaveMode": "file",
    "editor.codeActionsOnSave": {
        "source.organizeImports": "always",
        "source.fixAll": "always"
    },
    "files.autoSave": "onFocusChange",
    "[json]": {
        "editor.defaultFormatter": "vscode.json-language-features"
    },
    "[jsonc]": {
        "editor.defaultFormatter": "vscode.json-language-features"
    },
    // Debug settings
    "debug.toolBarLocation": "docked",
    // Terminal settings
    "terminal.integrated.tabs.enabled": true,
    "terminal.integrated.tabs.hideCondition": "never",
    "terminal.integrated.tabs.location": "right",
    // Markdown settings
    "markdown.preview.scrollEditorWithPreview": true,
    "markdown.preview.scrollPreviewWithEditor": true,
    "python.createEnvironment.contentButton": "show",
    "python.venvFolders": [
        ""
    ]
}

工作区设置 #

{
    // Python settings
    "python.analysis.autoSearchPaths": true,
    "python.analysis.diagnosticSeverityOverrides": {
        "reportMissingImports": "none"
    },
    "python.analysis.extraPaths": [
        "${workspaceFolder}/src"
    ],
    "python.envFile": "${workspaceFolder}/.env",
    "python.terminal.activateEnvironment": true,
    "python.defaultInterpreterPath": "${workspaceFolder}/.venv/bin/python",
    // Test settings
    "python.testing.pytestEnabled": true,
    "python.testing.unittestEnabled": false,
    "python.testing.cwd": "${workspaceFolder}/tests",
    "python.testing.pytestPath": "${workspaceFolder}/.venv/bin/pytest",
    "python.testing.autoTestDiscoverOnSaveEnabled": true
}

原因分析 #

1. Git忽略规则影响：用户设置里开启了"explorer.excludeGitIgnore": true，如果项目的.gitignore文件中包含.venv，VS Code会自动隐藏该文件夹。
2. 虚拟环境配置异常：用户设置中"python.venvFolders": [""]为空值，可能干扰VS Code对虚拟环境文件夹的识别逻辑，导致不显示。
3. 隐性排除规则：虽然当前files.exclude未直接排除.venv，但全局配置或第三方扩展可能存在隐性规则导致文件夹隐藏。

解决办法 #

1. 检查并修改.gitignore #

打开项目根目录的.gitignore文件：

• 若不需要忽略.venv，直接删除.venv这一行；
• 若仅临时显示，在该行前加#注释，例如# .venv。

2. 调整文件排除规则 #

在用户设置或工作区设置的files.exclude中添加强制显示.venv的规则：

"files.exclude": {
    ".git": true,
    "**/.git": false,
    "**/.venv": false
}

3. 修正虚拟环境文件夹配置 #

将用户设置里的python.venvFolders改为包含.venv的正常配置：

"python.venvFolders": [
    ".venv",
    "venv",
    ".env",
    "env"
]

4. 重启VS Code生效 #

按Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac），执行Reload Window命令，重启窗口让配置生效。

内容的提问来源于stack exchange，提问作者GEBRU