github/gitignore · Global/VisualStudioCode.gitignore
Template .gitignore do VS Code explicado
Explica por que o VisualStudioCode.gitignore exclui o conteúdo da pasta com .vscode/* e recupera com padrões de negação settings, tasks, launch e extensions, e os critérios para compartilhar.
O VisualStudioCode.gitignore é um template de manual para padrões de negação. Exclui todo o conteúdo da pasta .vscode/ e depois inclui de novo com ! apenas os arquivos de configuração que vale a pena compartilhar com a equipe.
O ponto-chave é estar escrito .vscode/* e não .vscode/. Se o próprio diretório for excluído, o git não olha dentro dele, então as regras ! seguintes não têm efeito algum.
Explicação regra por regra
| Padrão | O que ignora e por quê |
|---|---|
.vscode/* | Exclusão do conteúdo da pastaExclui de início todos os arquivos de .vscode, incluindo os caches e as configurações pessoais criados por extensões. Não exclui a pasta em si, então os arquivos internos podem ser recuperados. |
!.vscode/settings.json!.vscode/tasks.json!.vscode/launch.json | Configurações do workspace para compartilharAs configurações do formatador e do linter, as tarefas de build e as configurações de depuração ajudam a equipe a desenvolver do mesmo jeito. |
!.vscode/extensions.json!.vscode/*.code-snippets | Extensões recomendadas e snippetsextensions.json é a lista de extensões sugeridas para instalação ao abrir o projeto, e .code-snippets são trechos de código exclusivos do projeto. |
!*.code-workspace | Workspaces multirraizInclui de novo os arquivos de workspace que agrupam várias pastas, mesmo que algum template os ignore. |
*.vsix | Pacotes de extensão compiladosSão os pacotes de instalação criados com vsce package ao desenvolver extensões do VS Code. |
Cuidados na prática
- Não coloque preferências pessoais (tamanho da fonte, tema) no
settings.json; deixe-as nas configurações de usuário. As configurações do repositório valem para a equipe toda. - Se você colocou caminhos pessoais ou tokens no
launch.json, troque-os por variáveis como${workspaceFolder}antes de commitar. - Se quiser esconder
.vscode/por completo, em vez deste template adicione uma linha.vscode/ao gitignore global. Mas aí você abre mão de compartilhar as configurações da equipe.
Template original
VisualStudioCode.gitignore
# 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
Origem dos templates: github/gitignore/Global/VisualStudioCode.gitignore @356fd7b (2026-09-11) · CC0-1.0