github/gitignore · VisualStudio.gitignore
Template .gitignore do Visual Studio explicado
Explica por que o VisualStudio.gitignore ignora a pasta .vs, as configurações por usuário, os resultados de build Debug/Release, os pacotes NuGet, os resultados de testes e os perfis de publicação.
O VisualStudio.gitignore é um dos arquivos mais longos do repositório de templates e se destina a projetos C#, VB, C++ e ASP.NET desenvolvidos com o Visual Studio. Trata de forma ampla os arquivos por usuário criados pela IDE, as pastas de saída por configuração de build, o NuGet, as ferramentas de teste e cobertura e até os caches de extensões como o ReSharper.
Uma característica é ter muitos padrões que pegam maiúsculas e minúsculas com colchetes, como [Dd]ebug/, considerando os ambientes Windows que as misturam. O git diferencia maiúsculas e minúsculas por padrão, por isso essa notação é necessária.
Explicação regra por regra
| Padrão | O que ignora e por quê |
|---|---|
*.rsuser*.suo*.user*.userosscache*.sln.docstates.vs/ | Arquivos por usuárioÉ o estado pessoal da IDE: janelas abertas, breakpoints, projeto de inicialização. A pasta .vs/ também contém caches grandes, como o banco de dados do IntelliSense. |
[Dd]ebug/[Rr]elease/[Rr]eleases/bin/x64/obj/x86/[Oo]bj/**/[Bb]in/*bld/ | Saída por configuração de buildSão os resultados de compilação gerados por configuração (Debug/Release) e plataforma (x64/x86). **/[Bb]in/* exclui apenas o conteúdo da pasta bin, então, se necessário, dá para recuperar arquivos específicos com !. |
[Tt]est[Rr]esult*/*.trxTestResult.xmlnunit-*.xml*.VisualState.xml | Resultados de testesSão os arquivos de resultado deixados pelo MSTest e pelo NUnit. São reescritos a cada execução. |
*.nupkg*.snupkg**/[Pp]ackages/*!**/[Pp]ackages/build/*.nuget.props*.nuget.targets | NuGetSão arquivos que podem ser baixados de novo com a restauração de pacotes. Só a subpasta build de packages fica como exceção, para dar suporte aos casos em que scripts de build eram guardados à moda antiga. |
publish/*.pubxml*.publishprojPublishScripts/*.azurePubxml | Configurações de publicação e implantaçãoSão os resultados de implantação web e os perfis de publicação. Como explicam os comentários do template, um perfil de publicação pode conter strings de conexão de banco de dados sem criptografia. |
*.pdb*.pch*.ilk*.tlog*.tmp*.logipch/*.VC.db | Arquivos gerados e intermediáriosSão subprodutos do processo de build: símbolos de depuração, headers pré-compilados, logs de rastreamento do MSBuild, o banco de dados do IntelliSense de C++ etc. |
_ReSharper*/*.DotSettings.user_NCrunch_**.dotCover.axoCover/*!.axoCover/settings.json | Caches de extensõesSão caches criados por extensões como ReSharper, NCrunch, dotCover e AxoCover. Só o arquivo de configuração do AxoCover, compartilhado com a equipe, é incluído de novo. |
Cuidados na prática
- Se for preciso compartilhar os perfis de publicação pelo repositório, apague a linha
*.pubxml, mas continue excluindo o*.pubxml.user, que contém senhas. - Se você trabalha só com projetos do SDK moderno do .NET, o template Dotnet, mais curto, é mais fácil de ler. Se selecionar os dois, a opção de remover duplicatas organiza as regras que se sobrepõem.
- A regra
*.envignora todos os arquivos cujo nome termina em.env, então dê ao arquivo de exemplo outra extensão, comosample.env.example.
Template original
VisualStudio.gitignore
## Ignore Visual Studio temporary files, build results, and## files generated by popular Visual Studio add-ons.#### Get latest from https://github.com/github/gitignore/blob/main/VisualStudio.gitignore# User-specific files*.rsuser*.suo*.user*.userosscache*.sln.docstates*.env# User-specific files (MonoDevelop/Xamarin Studio)*.userprefs# Mono auto generated filesmono_crash.*# Build results[Dd]ebug/[Dd]ebugPublic/[Rr]elease/[Rr]eleases/[Dd]ebug/x64/[Dd]ebugPublic/x64/[Rr]elease/x64/[Rr]eleases/x64/bin/x64/obj/x64/[Dd]ebug/x86/[Dd]ebugPublic/x86/[Rr]elease/x86/[Rr]eleases/x86/bin/x86/obj/x86/[Ww][Ii][Nn]32/[Aa][Rr][Mm]/[Aa][Rr][Mm]64/[Aa][Rr][Mm]64[Ee][Cc]/bld/[Oo]bj/[Oo]ut/[Ll]og/[Ll]ogs/# Build results on 'Bin' directories**/[Bb]in/*# Uncomment if you have tasks that rely on *.refresh files to move binaries# (https://github.com/github/gitignore/pull/3736)#!**/[Bb]in/*.refresh# Visual Studio 2015/2017 cache/options directory.vs/# Uncomment if you have tasks that create the project's static files in wwwroot#wwwroot/# Visual Studio 2017 auto generated filesGenerated\ Files/# MSTest test Results[Tt]est[Rr]esult*/[Bb]uild[Ll]og.**.trx# NUnit*.VisualState.xmlTestResult.xmlnunit-*.xml# Approval Tests result files*.received.*# Build Results of an ATL Project[Dd]ebugPS/[Rr]eleasePS/dlldata.c# Benchmark ResultsBenchmarkDotNet.Artifacts/# .NET Coreproject.lock.jsonproject.fragment.lock.jsonartifacts/.artifacts/# ASP.NET ScaffoldingScaffoldingReadMe.txt# StyleCopStyleCopReport.xml# Files built by Visual Studio*_i.c*_p.c*_h.h*.ilk*.meta*.obj*.idb*.iobj*.pch*.pdb*.ipdb*.pgc*.pgd*.rsp# but not Directory.Build.rsp, as it configures directory-level build defaults!Directory.Build.rsp*.sbr*.tlb*.tli*.tlh*.tmp*.tmp_proj*_wpftmp.csproj*.log*.tlog*.vspscc*.vssscc.builds*.pidb*.svclog*.scc# Chutzpah Test files_Chutzpah*# Visual C++ cache filesipch/*.aps*.ncb*.opendb*.opensdf*.sdf*.cachefile*.VC.db*.VC.VC.opendb# Visual Studio profiler*.psess*.vsp*.vspx*.sap# Visual Studio Trace Files*.e2e# TFS 2012 Local Workspace$tf/# Guidance Automation Toolkit*.gpState# ReSharper is a .NET coding add-in_ReSharper*/*.[Rr]e[Ss]harper*.DotSettings.user# TeamCity is a build add-in_TeamCity*# DotCover is a Code Coverage Tool*.dotCover# AxoCover is a Code Coverage Tool.axoCover/*!.axoCover/settings.json# Coverlet is a free, cross platform Code Coverage Toolcoverage*.jsoncoverage*.xmlcoverage*.info# Visual Studio code coverage results*.coverage*.coveragexml# NCrunch_NCrunch_*.NCrunch_*.*crunch*.local.xmlnCrunchTemp_*# MightyMoose*.mm.*AutoTest.Net/# Web workbench (sass).sass-cache/# Installshield output folder[Ee]xpress/# DocProject is a documentation generator add-inDocProject/buildhelp/DocProject/Help/*.HxTDocProject/Help/*.HxCDocProject/Help/*.hhcDocProject/Help/*.hhkDocProject/Help/*.hhpDocProject/Help/Html2DocProject/Help/html# Click-Once directorypublish/# Publish Web Output*.[Pp]ublish.xml*.azurePubxml# Note: Comment the next line if you want to checkin your web deploy settings,# but database connection strings (with potential passwords) will be unencrypted*.pubxml*.publishproj# Microsoft Azure Web App publish settings. Comment the next line if you want to# checkin your Azure Web App publish settings, but sensitive information contained# in these scripts will be unencryptedPublishScripts/# NuGet Packages*.nupkg# NuGet Symbol Packages*.snupkg# The packages folder can be ignored because of Package Restore**/[Pp]ackages/*# except build/, which is used as an MSBuild target.!**/[Pp]ackages/build/# Uncomment if necessary however generally it will be regenerated when needed#!**/[Pp]ackages/repositories.config# NuGet v3's project.json files produces more ignorable files*.nuget.props*.nuget.targets# Microsoft Azure Build Outputcsx/*.build.csdef# Microsoft Azure Emulatorecf/rcf/# Windows Store app package directories and filesAppPackages/BundleArtifacts/Package.StoreAssociation.xml_pkginfo.txt*.appx*.appxbundle*.appxupload# Visual Studio cache files# files ending in .cache can be ignored*.[Cc]ache# but keep track of directories ending in .cache!?*.[Cc]ache/# OthersClientBin/~$**~*.dbmdl*.dbproj.schemaview*.jfm*.pfx*.publishsettingsorleans.codegen.cs# Including strong name files can present a security risk# (https://github.com/github/gitignore/pull/2483#issue-259490424)#*.snk# Since there are multiple workflows, uncomment next line to ignore bower_components# (https://github.com/github/gitignore/pull/1529#issuecomment-104372622)#bower_components/# RIA/Silverlight projectsGenerated_Code/# Backup & report files from converting an old project file# to a newer Visual Studio version. Backup files are not needed,# because we have git ;-)_UpgradeReport_Files/Backup*/UpgradeLog*.XMLUpgradeLog*.htmServiceFabricBackup/*.rptproj.bak# SQL Server files*.mdf*.ldf*.ndf# Business Intelligence projects*.rdl.data*.bim.layout*.bim_*.settings*.rptproj.rsuser*- [Bb]ackup.rdl*- [Bb]ackup ([0-9]).rdl*- [Bb]ackup ([0-9][0-9]).rdl# Microsoft FakesFakesAssemblies/# GhostDoc plugin setting file*.GhostDoc.xml# Node.js Tools for Visual Studio.ntvs_analysis.datnode_modules/# Visual Studio 6 build log*.plg# Visual Studio 6 workspace options file*.opt# Visual Studio 6 auto-generated workspace file (contains which files were open etc.)*.vbw# Visual Studio 6 workspace and project file (working project files containing files to include in project)*.dsw*.dsp# Visual Studio 6 technical files*.ncb*.aps# Visual Studio LightSwitch build output**/*.HTMLClient/GeneratedArtifacts**/*.DesktopClient/GeneratedArtifacts**/*.DesktopClient/ModelManifest.xml**/*.Server/GeneratedArtifacts**/*.Server/ModelManifest.xml_Pvt_Extensions# Paket dependency manager**/.paket/paket.exepaket-files/# FAKE - F# Make**/.fake/# CodeRush personal settings**/.cr/personal# Python Tools for Visual Studio (PTVS)**/__pycache__/*.pyc# Cake - Uncomment if you are using it#tools/**#!tools/packages.config# Tabs Studio*.tss# Telerik's JustMock configuration file*.jmconfig# BizTalk build output*.btp.cs*.btm.cs*.odx.cs*.xsd.cs# OpenCover UI analysis resultsOpenCover/# Azure Stream Analytics local run outputASALocalRun/# MSBuild Binary and Structured Log*.binlogMSBuild_Logs/# AWS SAM Build and Temporary Artifacts folder.aws-sam# NVidia Nsight GPU debugger configuration file*.nvuser# MFractors (Xamarin productivity tool) working folder**/.mfractor/# Local History for Visual Studio**/.localhistory/# Visual Studio History (VSHistory) files.vshistory/# BeatPulse healthcheck temp databasehealthchecksdb# Backup folder for Package Reference Convert tool in Visual Studio 2017MigrationBackup/# Ionide (cross platform F# VS Code tools) working folder**/.ionide/# Fody - auto-generated XML schemaFodyWeavers.xsd# VS Code files for those working on multiple tools.vscode/*!.vscode/settings.json!.vscode/tasks.json!.vscode/launch.json!.vscode/extensions.json!.vscode/*.code-snippets# Local History for Visual Studio Code.history/# Built Visual Studio Code Extensions*.vsix# Windows Installer files from build outputs*.cab*.msi*.msix*.msm*.msp# Official VS Code C# Dev Kit Extension exclusion#*.lscache
Origem dos templates: github/gitignore/VisualStudio.gitignore @356fd7b (2026-09-11) · CC0-1.0