github/gitignore · VisualStudio.gitignore
Plantilla .gitignore de Visual Studio explicada
Explica por qué VisualStudio.gitignore ignora la carpeta .vs, los ajustes por usuario, los resultados de compilación Debug/Release, los paquetes NuGet, los resultados de pruebas y los perfiles de publicación.
VisualStudio.gitignore es uno de los archivos más largos del repositorio de plantillas y está dirigido a proyectos C#, VB, C++ y ASP.NET desarrollados con Visual Studio. Trata de forma amplia los archivos por usuario que crea el IDE, las carpetas de salida por configuración de compilación, NuGet, las herramientas de pruebas y cobertura, e incluso las cachés de extensiones como ReSharper.
Una característica es que tiene muchos patrones que capturan mayúsculas y minúsculas con corchetes, como [Dd]ebug/, teniendo en cuenta los entornos Windows que las mezclan. git distingue mayúsculas y minúsculas por defecto, por eso hace falta esta notación.
Explicación regla por regla
| Patrón | Qué ignora y por qué |
|---|---|
*.rsuser*.suo*.user*.userosscache*.sln.docstates.vs/ | Archivos por usuarioEs el estado personal del IDE: ventanas abiertas, puntos de interrupción, proyecto de inicio. La carpeta .vs/ también contiene cachés grandes como la base de datos de IntelliSense. |
[Dd]ebug/[Rr]elease/[Rr]eleases/bin/x64/obj/x86/[Oo]bj/**/[Bb]in/*bld/ | Salida por configuración de compilaciónSon los resultados de compilación que se generan por configuración (Debug/Release) y plataforma (x64/x86). **/[Bb]in/* excluye solo el contenido de la carpeta bin, así que si hace falta se pueden recuperar archivos concretos con !. |
[Tt]est[Rr]esult*/*.trxTestResult.xmlnunit-*.xml*.VisualState.xml | Resultados de pruebasSon los archivos de resultados que dejan MSTest y NUnit. Se reescriben en cada ejecución. |
*.nupkg*.snupkg**/[Pp]ackages/*!**/[Pp]ackages/build/*.nuget.props*.nuget.targets | NuGetSon archivos que se pueden volver a descargar con la restauración de paquetes. Solo se deja como excepción la subcarpeta build de packages, para dar soporte a los casos en que se guardaban scripts de compilación a la antigua usanza. |
publish/*.pubxml*.publishprojPublishScripts/*.azurePubxml | Configuración de publicación e implementaciónSon los resultados de implementación web y los perfiles de publicación. Como explican los comentarios de la plantilla, un perfil de publicación puede contener cadenas de conexión a bases de datos sin cifrar. |
*.pdb*.pch*.ilk*.tlog*.tmp*.logipch/*.VC.db | Archivos generados e intermediosSon subproductos del proceso de compilación: símbolos de depuración, cabeceras precompiladas, registros de seguimiento de MSBuild, la base de datos de IntelliSense de C++, etc. |
_ReSharper*/*.DotSettings.user_NCrunch_**.dotCover.axoCover/*!.axoCover/settings.json | Cachés de extensionesSon cachés que crean extensiones como ReSharper, NCrunch, dotCover y AxoCover. Solo se vuelve a incluir el archivo de configuración de AxoCover que se comparte con el equipo. |
Precauciones en la práctica
- Si necesitas compartir los perfiles de publicación en el repositorio, borra la línea
*.pubxml, pero sigue excluyendo*.pubxml.user, que contiene contraseñas. - Si solo trabajas con proyectos del SDK moderno de .NET, la plantilla Dotnet, más corta, es más fácil de leer. Si seleccionas ambas, la opción de eliminar duplicados ordena las reglas que se solapan.
- La regla
*.envignora todos los archivos cuyo nombre termina en.env, así que pon el archivo de ejemplo con otra extensión, comosample.env.example.
Plantilla 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
Origen de las plantillas: github/gitignore/VisualStudio.gitignore @356fd7b (2026-09-11) · CC0-1.0