github/gitignore · VisualStudio.gitignore
Visual Studio .gitignore 템플릿 해설
VisualStudio.gitignore가 .vs 폴더, 사용자별 설정, Debug/Release 빌드 결과, NuGet 패키지, 테스트 결과, 게시 프로필을 무시하는 이유를 설명합니다.
VisualStudio.gitignore는 템플릿 저장소에서 가장 긴 파일 중 하나로, Visual Studio로 개발하는 C#·VB·C++·ASP.NET 프로젝트를 대상으로 한다. IDE가 만드는 사용자별 파일, 빌드 구성별 출력 폴더, NuGet, 테스트·커버리지 도구, ReSharper 같은 확장의 캐시까지 폭넓게 다룬다.
대소문자를 섞어 쓰는 Windows 환경을 고려해 [Dd]ebug/처럼 브래킷으로 대소문자를 모두 잡는 패턴이 많은 것이 특징이다. git은 기본적으로 대소문자를 구분하므로 이런 표기가 필요하다.
규칙별 해설
| 패턴 | 무엇을, 왜 무시하나 |
|---|---|
*.rsuser*.suo*.user*.userosscache*.sln.docstates.vs/ | 사용자별 파일열린 창, 중단점, 시작 프로젝트 같은 개인 IDE 상태다. .vs/ 폴더에는 IntelliSense 데이터베이스처럼 큰 캐시도 들어 있다. |
[Dd]ebug/[Rr]elease/[Rr]eleases/bin/x64/obj/x86/[Oo]bj/**/[Bb]in/*bld/ | 빌드 구성별 출력구성(Debug/Release)과 플랫폼(x64/x86)마다 생기는 컴파일 결과다. **/[Bb]in/*는 bin 폴더 안의 내용만 제외하는 형태라 필요하면 특정 파일을 !로 되살릴 수 있다. |
[Tt]est[Rr]esult*/*.trxTestResult.xmlnunit-*.xml*.VisualState.xml | 테스트 결과MSTest·NUnit이 남기는 결과 파일이다. 실행할 때마다 새로 쓰인다. |
*.nupkg*.snupkg**/[Pp]ackages/*!**/[Pp]ackages/build/*.nuget.props*.nuget.targets | NuGet패키지 복원으로 다시 받을 수 있는 파일이다. packages 폴더의 build 하위만 예외로 남겨 두어, 예전 방식으로 빌드 스크립트를 넣어 둔 경우를 지원한다. |
publish/*.pubxml*.publishprojPublishScripts/*.azurePubxml | 게시·배포 설정웹 배포 결과와 게시 프로필이다. 템플릿 주석이 설명하듯 게시 프로필에는 데이터베이스 연결 문자열이 암호화되지 않은 채 들어갈 수 있다. |
*.pdb*.pch*.ilk*.tlog*.tmp*.logipch/*.VC.db | 생성·중간 파일디버그 심볼, 미리 컴파일된 헤더, MSBuild 추적 로그, C++ IntelliSense 데이터베이스 등 빌드 과정의 부산물이다. |
_ReSharper*/*.DotSettings.user_NCrunch_**.dotCover.axoCover/*!.axoCover/settings.json | 확장 도구 캐시ReSharper, NCrunch, dotCover, AxoCover 같은 확장이 만드는 캐시다. 팀과 공유할 AxoCover 설정 파일만 다시 포함한다. |
실무에서 주의할 점
- 게시 프로필을 저장소로 공유해야 한다면
*.pubxml줄을 지우되, 비밀번호가 들어간*.pubxml.user는 계속 제외한다. - 최신 .NET SDK 프로젝트만 다룬다면 더 짧은 Dotnet 템플릿이 읽기 쉽다. 두 템플릿을 함께 선택하면 중복 제거 옵션이 겹치는 규칙을 정리한다.
*.env규칙은 이름이.env로 끝나는 파일을 모두 무시하므로, 예시 파일은sample.env.example처럼 다른 확장자로 둔다.
원본 템플릿
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
템플릿 출처: github/gitignore/VisualStudio.gitignore @356fd7b (2026-09-11) · CC0-1.0