vscode scm面板默认不显示untracked文件是因为git.untrackedchanges配置默认为hidden，这是为避免临时文件干扰；改为separate或mixed即可显示，需确保仓库根目录正确、.gitignore未忽略该文件且未超git.ignorelimit限制。
Git 面板为什么默认不显示 untracked 文件
VSCode 的源代码管理（SCM）面板默认只显示已暂存（staged）或已修改（modified）的文件，untracked 文件不会自动出现在列表里——这不是 bug，是 Git 本身的设计逻辑：未追踪文件尚未被纳入版本控制，VSCode 默认选择“不主动打扰”，避免面板被大量临时文件、构建产物塞满。
但开发中你确实需要看到它们，比如刚新建一个 utils.ts 想立刻 git add，结果在面板里找不到。
- 根本原因在于 VSCode 的 Git 扩展默认启用了
git.untrackedChanges配置项，其值为hidden - 该行为与命令行
git status不同：CLI 默认展示 untracked，而 VSCode SCM 面板做了收敛处理 - 不影响实际 Git 功能，只是 UI 层过滤掉了
如何让未追踪文件出现在 SCM 面板
只需改一个设置，无需插件、无需重启 VSCode（改完立即生效）：
- 打开设置（
Ctrl+,或Cmd+,），搜索git.untrackedChanges - 将值从
hidden改为separate（推荐）或mixed -
separate：在 SCM 面板底部新增 “Untracked” 区块，和其他变更类型（Changes、Staged Changes）并列 -
mixed：把 untracked 文件混进 “Changes” 列表里，和 modified 文件一起显示（可能造成混淆）
对应 JSON 设置项是：
"git.untrackedChanges": "separate"
为什么有时改了设置还是看不到 untracked 文件
常见干扰因素比想象中多，尤其容易卡在以下几点：
- 工作区根目录下存在
.gitignore，且新文件匹配了其中某条规则（比如node_modules/或dist/）——这类文件即使未追踪也不会显示 - VSCode 当前打开的是子文件夹而非 Git 仓库根目录（即没有检测到
.git文件夹）——检查左下角状态栏是否显示分支名，没显示说明没识别到 repo - 文件刚创建完，VSCode 文件监视器还没触发刷新（极少见，可按
Ctrl+Shift+P→ 输入Developer: Restart Language Server强制重载） - 某些 Git 扩展（如 GitLens）覆盖了原生 SCM 行为，可临时禁用验证是否冲突
额外提醒：别忽略 .gitignore 和 workspace 设置的影响
全局或工作区级别的 git.ignoreLimit 或 files.exclude 可能间接压制 untracked 文件的可见性：
-
files.exclude是 VSCode 的文件资源管理器过滤项，它**不影响 SCM 面板**，但容易让人误以为“文件消失了” -
git.ignoreLimit控制 Git 扩展扫描未追踪文件的数量上限，默认 10000；如果项目里有海量日志或缓存文件，超出后 untracked 区块可能为空——此时需调高该值 - 工作区设置（
.vscode/settings.json）中的git.untrackedChanges会覆盖用户级设置，检查是否被意外锁定为hidden
真正起效的永远是当前工作区识别到的 Git 仓库 + 对应的 .gitignore + VSCode 的 git.untrackedChanges 三者共同作用。漏掉任意一环，都可能让你对着空白的 “Untracked” 区块发呆。
