بهینه‌سازی محیط توسعه محلی در Next.js – افزایش سرعت کامپایل و تجربهٔ توسعه روان‌تر

با رشد اپلیکیشن‌های Next.js، ممکن است سرعت کامپایل در محیط توسعه کاهش یابد. این مقاله راهکارهایی برای بهبود عملکرد توسعه محلی ارائه می‌دهد؛ از جمله تنظیمات آنتی‌ویروس، استفاده از Turbopack، بهینه‌سازی importها، پیکربندی Tailwind CSS، و ابزارهای تشخیص مشکلات مانند Turbopack Tracing.

Next.jsLocal DevelopmentTurbopackCompile PerformanceCompile Performance

~3 min read · Updated Oct 28, 2025

تفاوت توسعه محلی با تولیدی


دستور next dev فقط مسیرهایی را کامپایل می‌کند که بازدید می‌شوند، در حالی که next build و next start شامل بهینه‌سازی‌هایی مانند minify و hashگذاری فایل‌ها هستند. این باعث می‌شود توسعه محلی سریع‌تر و سبک‌تر باشد.


۱. بررسی آنتی‌ویروس سیستم


آنتی‌ویروس می‌تواند سرعت دسترسی به فایل‌ها را کاهش دهد. در ویندوز، پوشه پروژه را به لیست استثناهای Microsoft Defender اضافه کنید. در macOS، با دستور زیر حالت توسعه‌دهنده را فعال کنید:

sudo spctl developer-mode enable-terminal

سپس به System Settings → Privacy & Security → Developer Tools بروید و ترمینال خود را فعال کنید.


۲. به‌روزرسانی Next.js و استفاده از Turbopack


نسخهٔ جدید Next.js را نصب کنید تا از بهبودهای عملکردی بهره‌مند شوید. Turbopack به‌صورت پیش‌فرض فعال است:

npm install next@latest
npm run dev

برای استفاده از Webpack:

npm run dev --webpack

۳. بهینه‌سازی importها


وارد کردن کل کتابخانه‌ها یا استفاده از barrel fileها می‌تواند سرعت کامپایل را کاهش دهد. به‌جای آن، از import مستقیم استفاده کنید:

// نادرست:
import { TriangleIcon } from '@phosphor-icons/react'

// درست:
import { TriangleIcon } from '@phosphor-icons/react/dist/csr/Triangle'

از یک مجموعه آیکون استفاده کنید و از ترکیب چند مجموعه پرهیز کنید.


۴. پیکربندی Tailwind CSS


در فایل tailwind.config.js، مسیرهای اسکن را محدود کنید:

module.exports = {
  content: ['./src/**/*.{js,ts,jsx,tsx}'], // مناسب
}

از اسکن مسیرهایی مانند node_modules خودداری کنید.


۵. بررسی تنظیمات سفارشی Webpack


تنظیمات سفارشی Webpack ممکن است باعث کندی شوند. در صورت امکان، از Turbopack استفاده کنید یا تنظیمات را فقط برای build تولیدی فعال کنید.


۶. بهینه‌سازی مصرف حافظه


اگر اپلیکیشن شما بزرگ است، ممکن است به حافظه بیشتری نیاز داشته باشد. ماژول‌ها را تقسیم کنید یا از وابستگی‌های سبک‌تر استفاده کنید.


۷. Server Component و واکشی داده


تغییر در Server Component باعث رندر مجدد کل صفحه می‌شود. از گزینهٔ آزمایشی serverComponentsHmrCache برای کش کردن پاسخ‌های fetch در HMR استفاده کنید.


۸. توسعه محلی به‌جای Docker


Docker در macOS و Windows ممکن است باعث کندی HMR شود. برای بهترین عملکرد:

  • از npm run dev به‌صورت محلی استفاده کنید
  • Docker را برای build و تست تولیدی نگه دارید
  • در صورت نیاز، از Docker در لینوکس یا VM استفاده کنید

ابزارهای تشخیص مشکلات


لاگ‌گیری دقیق fetch


module.exports = {
  logging: {
    fetches: {
      fullUrl: true,
    },
  },
}

ردیابی Turbopack


NEXT_TURBOPACK_TRACING=1 npm run dev

پس از بازتولید مشکل، سرور را متوقف کرده و اجرا کنید:

npx next internal trace .next/dev/trace-turbopack

سپس فایل را در trace.nextjs.org مشاهده کنید.


جمع‌بندی


با بهینه‌سازی محیط توسعه محلی در Next.js می‌توانید تجربه‌ای سریع‌تر و روان‌تر داشته باشید. با به‌روزرسانی وابستگی‌ها، بهینه‌سازی importها، پیکربندی Tailwind و استفاده از ابزارهای تشخیصی، زمان کامپایل را کاهش داده و بهره‌وری خود را افزایش دهید.


Written & researched by Dr. Shahin Siami

Related Articles

مسیریابی پیشرفته و هوک‌های عملکرد در Next.js — راهنمای توسعه‌دهنده برای App Router

Next.js مجموعه‌ای غنی از هوک‌های کلاینت و ابزارهای کش و ناوبری را در اختیار توسعه‌دهندگان قرار می‌دهد. از خواندن پارامترهای مسیر تا گزارش Web Vitals و مدیریت کش، این مقاله مهم‌ترین ابزارهای App Router را با مثال‌های کاربردی معرفی می‌کند.

Continue

مدیریت احراز هویت و کش در Next.js — راهنمای توسعه‌دهنده برای امنیت و عملکرد پویا

Next.js با معرفی قابلیت‌های آزمایشی جدید، امکان کنترل دقیق‌تر دسترسی و کش داده‌ها را فراهم کرده است. تابع unauthorized برای مدیریت خطای 401 و هدایت کاربران به صفحه ورود، unstable_cache برای کش هوشمند عملیات سنگین، updateTag برای بازسازی آنی داده‌ها، و useLinkStatus برای نمایش وضعیت ناوبری استفاده می‌شوند. این مقاله نحوه استفاده از این ابزارها را با مثال‌های کاربردی و نکات مهم بررسی می‌کند.

Continue

redirect و refresh در Next.js — ریدایرکت‌های هوشمند و تازه‌سازی مسیر در Server Actions

تابع redirect در Next.js برای هدایت کاربر به مسیر جدید استفاده می‌شود و بسته به نوع استفاده، پاسخ HTTP با وضعیت 307 یا 303 ارسال می‌کند. این تابع در Server Components، Client Components، Route Handlers و Server Actions قابل استفاده است. تابع refresh نیز برای تازه‌سازی مسیر کلاینت از درون Server Action استفاده می‌شود. این مقاله نحوه استفاده از هر دو تابع را با مثال‌های کاربردی و نکات مهم توضیح می‌دهد.

Continue

Next.js با معرفی NextRequest و NextResponse، APIهای Request و Response مرورگر را گسترش داده و ابزارهای قدرتمندی برای مدیریت کوکی‌ها، هدرها، ریدایرکت‌ها، بازنویسی مسیرها و پاسخ‌های JSON فراهم کرده است. این مقاله نحوه استفاده از این ابزارها را با مثال‌های کاربردی و نکات امنیتی توضیح می‌دهد.

Next.js با معرفی NextRequest و NextResponse، APIهای Request و Response مرورگر را گسترش داده و ابزارهای قدرتمندی برای مدیریت کوکی‌ها، هدرها، ریدایرکت‌ها، بازنویسی مسیرها و پاسخ‌های JSON فراهم کرده است. این مقاله نحوه استفاده از این ابزارها را با مثال‌های کاربردی و نکات امنیتی توضیح می‌دهد.

Continue

headers، ImageResponse، notFound و permanentRedirect در Next.js — مدیریت درخواست‌ها، تولید تصویر، خطا و ریدایرکت

Next.js ابزارهای قدرتمندی برای مدیریت درخواست‌ها و پاسخ‌ها در کامپوننت‌های سروری فراهم کرده است. تابع headers برای خواندن هدرهای HTTP ورودی، ImageResponse برای تولید تصاویر داینامیک، notFound برای نمایش صفحه خطای 404، و permanentRedirect برای ریدایرکت دائمی کاربران استفاده می‌شوند. این مقاله نحوه استفاده از هر یک را با مثال‌های کاربردی توضیح می‌دهد.

Continue

راهنمای کامل استفاده از metadata و generateMetadata در Next.js

در نسخه‌های مدرن Next.js، مدیریت metadata صفحات بسیار قدرتمندتر و ساده‌تر شده است. metadata به‌صورت خودکار در تگ <head> صفحات تزریق می‌شود و نقش مهمی در SEO، اشتراک‌گذاری اجتماعی و تجربه کاربری دارد. این مقاله دو روش اصلی تعریف metadata را بررسی می‌کند: استفاده از آبجکت ثابت metadata و تابع داینامیک generateMetadata.

Continue