github/gitignore · Global/VisualStudioCode.gitignore

VS Code .gitignore 模板详解

说明 VisualStudioCode.gitignore 用 .vscode/* 排除目录内容、再用否定模式恢复 settings、tasks、launch、extensions 文件的原因,以及共享的标准。

在生成器中打开 与 Node, Python, macOS, Windows 一起打开

VisualStudioCode.gitignore 堪称否定模式的教科书。它先排除 .vscode/ 目录中的全部内容,然后只用 ! 重新包含值得与团队共享的配置文件。

这里的关键在于写成 .vscode/* 而不是 .vscode/。如果排除目录本身,git 就不会查看其中内容,后面的 ! 规则也就完全不起作用。

逐条规则详解

模式忽略什么,为什么忽略
.vscode/*排除目录内容先排除 .vscode 中的所有文件,包括扩展生成的缓存和个人设置。由于没有排除目录本身,可以恢复其中的文件。
!.vscode/settings.json!.vscode/tasks.json!.vscode/launch.json共享的工作区设置格式化工具与代码检查设置、构建任务、调试配置有助于团队以相同方式开发。
!.vscode/extensions.json!.vscode/*.code-snippets推荐扩展与代码片段extensions.json 是打开项目时建议安装的扩展列表,.code-snippets 是项目专用的代码片段。
!*.code-workspace多根工作区即使某个模板忽略了用于组合多个目录的工作区文件,也会重新包含它。
*.vsix构建的扩展包开发 VS Code 扩展时用 vsce package 生成的安装包。

实践中的注意事项

原始模板

VisualStudioCode.gitignore规则 8 行
# Visual Studio Code.vscode/*!.vscode/settings.json!.vscode/tasks.json!.vscode/launch.json!.vscode/extensions.json!.vscode/*.code-snippets!*.code-workspace# Built Visual Studio Code Extensions*.vsix

模板来源: github/gitignore/Global/VisualStudioCode.gitignore @356fd7b (2026-09-11) · CC0-1.0

常搭配使用的模板

其他模板详解