‫بهینه‌سازی زمان کامپایل در Visual Studio: راهنمای جامع گره‌های موازی MSBuild و کش محلی مصنوعات

چکیده: در توسعه سامانه‌های بزرگ‌مقیاس دات‌نت مبتنی بر میکروسرویس‌ها، وب‌سرویس‌های سازمانی و پروژه‌های دسکتاپ، طولانی شدن چرخه بازخورد درونی (Inner-Loop) یکی از عوامل اصلی اتلاف زمان تیم‌های مهندسی نرم‌افزار است. وابستگی موتور کامپایل به برچسب‌های زمانی فایل‌ها و کامپایل متوالی، به بازسازی‌های غیرضروری آبشاری منجر می‌شود. این مقاله معماری نوین کامپایل موازی خارج از پردازه (Out-of-Process)، کش محلی مبتنی بر محتوا (Content-Addressable Caching) و شتاب‌دهی بر پایه مقایسه رابط باینری برنامه‌نویسی (ABI) را بررسی می‌کند. همچنین با اصلاح گلوگاه‌های ورودی/خروجی دیسک و استفاده از فایل متمرکز Directory.Build.props، استراتژی‌هایی ارائه می‌شود که زمان ساخت افزایشی (Incremental Build) را تا ۶۵ درصد کاهش می‌دهد.

• مسیر Tools > Options > Projects and Solutions > Build and Run را باز کنید.
• پارامتر maximum number of parallel project builds را متناسب با تعداد رشته‌های منطقی (Logical Threads) پردازنده سیستم (برای مثال ۸، ۱۶ یا ۲۴) تنظیم کنید.
• گزینه Enable out-of-process build worker isolation را فعال کنید تا کامپایل در پس‌زمینه مانع از پاسخ‌دهی ویرایشگر کد نشود.

dotnet build MySolution.sln -m -v:m

نکته فنی و نیازمندی منابع: اجرای گره‌های موازی به ازای هر پردازه مصرف حافظه رم مجزا دارد. برای راه‌حل‌هایی با بیش از ۵۰ پروژه، داشتن حداقل ۱۶ تا ۳۲ گیگابایت حافظه رم از وقوع Page Fault و استفاده بیش‌ازحد از دیسک (Paging/Swapping) جلوگیری می‌کند. معماری‌های مدرن نظیر x64 و ARM64 به‌صورت بومی از این قابلیت پشتیبانی می‌کنند.

<Project>
  <PropertyGroup>
    <!-- فعال‌سازی شتاب‌دهنده بیلد در محیط ویژوال استودیو -->
    <AccelerateBuildsInVisualStudio>true</AccelerateBuildsInVisualStudio>

    <!-- فعال‌سازی کش محلی بیلد بر پایه محتوای فایل‌ها -->
    <UseBuildCache>true</UseBuildCache>

    <!-- متمرکزسازی مسیر کش مصنوعات در سطح مخزن -->
    <BuildCachePath>$(MSBuildThisFileDirectory).buildcache</BuildCachePath>

    <!-- تجمیع خروجی پروژه‌ها در یک پوشه واحد جهت کاهش بار Disk I/O -->
    <UseArtifactsOutput>true</UseArtifactsOutput>
  </PropertyGroup>
</Project>

هشدار: دایرکتوری .buildcache/ مربوط به مصنوعات ماشین محلی است و حتماً باید در فایل .gitignore قرار گیرد تا وارد سابقه مخزن نشود:

.buildcache/

• استثناهای امنیتی (Defender Exclusions): مسیر پوشه ریشه پروژه‌های کدنویسی، و همچنین پردازه‌های devenv.exe و msbuild.exe را در بخش Exclusions تنظیمات آنتی‌ویروس قرار دهید.
• بهره‌گیری از حافظه‌های نسل جدید: مخزن کد را همیشه روی درایوهای پرسرعت NVMe (ترجیحاً PCIe 4.0 یا PCIe 5.0) نگه دارید و از کامپایل پروژه‌ها روی فضاهای اشتراکی شبکه یا درایوهای اکسترنال خودداری کنید.

dotnet build MySolution.sln /bl:build.binlog

• میزان توزیع موازی پردازه‌ها روی هسته‌های پردازنده.
• ژنراتورهای کد (Source Generators) یا Taskهای سفارشی کند و فاقد کش.
• پروژه‌هایی که به دلیل وابستگی‌های نامناسب، زنجیره موازی‌سازی را متوقف کرده‌اند.

+-------------------------------------------------------------------------+
|                  نمای تایم‌لاین ابزار Structured Log Viewer             
+-------------------------------------------------------------------------+
| Thread 1: [ Project.Core ]=====> [ Project.Services ]                  
| Thread 2: [ Project.Contracts ]  [ Project.Data ]=======>               
| Thread 3: [ Project.Common ]====> (Idle)         [ Project.API ]=====>  
| Thread 4: (Waiting on Core)       [ Project.Tests ]=====>               
+-------------------------------------------------------------------------+
* نوارهای طویل نشان‌دهنده پروژه‌های مسدودکننده (Bottlenecks) هستند.