github/gitignore · VisualStudio.gitignore
شرح قالب .gitignore لـ Visual Studio
يشرح سبب تجاهل VisualStudio.gitignore لمجلد .vs والإعدادات الخاصة بكل مستخدم ونتائج بناء Debug/Release وحزم NuGet ونتائج الاختبارات وملفات تعريف النشر.
VisualStudio.gitignore من أطول الملفات في مستودع القوالب، ويستهدف مشاريع C# وVB وC++ وASP.NET التي تُطوَّر في Visual Studio. يغطي على نطاق واسع الملفات الخاصة بكل مستخدم التي تنشئها بيئة التطوير، ومجلدات المخرجات لكل تهيئة بناء، وNuGet، وأدوات الاختبار والتغطية، وذاكرات الإضافات مثل ReSharper.
من سماته كثرة الأنماط التي تلتقط الأحرف الكبيرة والصغيرة معًا عبر الأقواس مثل [Dd]ebug/، مراعاةً لبيئة Windows التي تُخلط فيها حالة الأحرف. ولأن git يميّز حالة الأحرف افتراضيًا، فهذه الصياغة ضرورية.
شرح القواعد
| النمط | ما الذي يتجاهله ولماذا |
|---|---|
*.rsuser*.suo*.user*.userosscache*.sln.docstates.vs/ | الملفات الخاصة بكل مستخدمحالة بيئة التطوير الشخصية مثل النوافذ المفتوحة ونقاط التوقف ومشروع البدء. ويحوي مجلد .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ملفات يمكن تنزيلها مجددًا عبر استعادة الحزم. يُستثنى المجلد الفرعي build داخل مجلد packages فقط، دعمًا للحالات القديمة التي وُضعت فيها سكربتات البناء هناك. |
publish/*.pubxml*.publishprojPublishScripts/*.azurePubxml | إعدادات النشرنتائج النشر على الويب وملفات تعريف النشر. كما توضح تعليقات القالب، قد تتضمن ملفات تعريف النشر سلاسل الاتصال بقاعدة البيانات دون تشفير. |
*.pdb*.pch*.ilk*.tlog*.tmp*.logipch/*.VC.db | الملفات المولَّدة والوسيطةمخلفات عملية البناء مثل رموز التصحيح، والترويسات المترجمة مسبقًا، وسجلات تتبع MSBuild، وقاعدة بيانات IntelliSense لـ C++. |
_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