راه‌اندازی محیط توسعه محلی؛ چک‌لیست کامل برای شروع پروژه

محیط توسعهٔ محلی چیست و چرا مهم است؟

محیط توسعهٔ محلی (Local Development Environment) مجموعهٔ ابزارهایی است که روی کامپیوتر خودتان اجرا می‌شود تا کد بنویسید، اجرا کنید و آزمایش کنید؛ گاهی حتی بدون یک ثانیه اتصال به اینترنت. نسخهٔ زندهٔ محصول روی سرور «تولید» (Production) است و محلی، آزمایشگاه شخصی شماست؛ اشتباه در آزمایشگاه رایگان است اما روی سرور واقعی هزینه دارد. همین تفاوت ساده، دلیل جدی‌بودن این مرحله است.

تازه‌کارها معمولاً همهٔ انرژی را روی انتخاب ادیتور می‌گذارند، در حالی که ادیتور فقط یکی از پنج قطعهٔ پازل است. محیطِ درست یعنی بعداً با خطاهای محیطی کمتری روبه‌رو می‌شوید و وقتتان صرف خودِ برنامه‌نویسی می‌شود، نه جنگیدن با تنظیمات. در ادامه، همان پازل پنج‌تکه را به ترتیب نصب می‌چینیم.

نصب ابزارها به ترتیب درست

ترتیب نصب مهم است چون هر ابزار روی قبلی سوار می‌شود:

• زبان یا Runtime: برای مسیر وب، Node.js را بگیرید (نسخهٔ LTS، نه آخرین نسخه) و اگر مسیر پایتون را رفته‌اید، خود پایتون؛ LTS یعنی پایدار و پشتیبانی‌شده.
• مدیریت پکیج: npm همراه Node نصب می‌شود و در پایتون، pip از قبل موجود است.
• ادیتور: VS Code رایگان و پرکاربردترین انتخاب است؛ تنظیم حرفه‌ای VS Code را بخوانید تا از روز اول درست پیکربندی کنید.
• Git: نسخه‌بندی کد از همان commit اول شروع می‌شود؛ آموزش گیت و گیت‌هاب همراهِ لازم این مرحله است.
• ترمینال: کار با خط فرمان را جدی بگیرید؛ مهارت‌های ترمینال بعدها ده‌ها ساعت برایتان ذخیره می‌کند.

بعد از هر نصب، در ترمینال نسخه را چک کنید (node -v یا python --version). اگر نسخه چاپ شد، یعنی نصب واقعاً انجام شده؛ این عادت کوچک، جلوی ساعت‌ها سردرگمی «چرا کار نمی‌کند؟» را می‌گیرد.

مدیریت نسخه‌ها: nvm و venv

بعد از دومین پروژه متوجه می‌شوید هر پروژه نسخهٔ خودش را می‌خواهد؛ یکی با Node ۱۸ راحت اجرا می‌شود و دیگری به ۲۲ نیاز دارد. راه‌حل دنیای Node، ابزار nvm است: با nvm install --lts نسخهٔ پایدار را نصب می‌کنید، با nvm use 18 برای هر پروژه نسخهٔ دلخواه را فعال می‌کنید و دیگر هیچ‌وقت بین پروژه‌ها قربانی جنگ نسخه‌ها نمی‌شوید.

در دنیای پایتون همین نقش را venv بازی می‌کند: با python -m venv .venv یک محیط جدا برای هر پروژه می‌سازید و بعد از فعال‌کردنش، هر پکیجی فقط داخل همان محیط نصب می‌شود. قاعدهٔ طلایی هر دو دنیا یکی است: هر پروژه، محیط ایزولهٔ خودش؛ هیچ پکیجی سراسری نصب نشود مگر واقعاً ضروری باشد. همین یک قاعده، بیشترِ دردسرهای «روی سیستم من کار می‌کند!» را از ریشه حذف می‌کند.

متغیرهای محیطی و فایل .env

آدرس دیتابیس، کلید API و شمارهٔ پورت نباید داخل کد نوشته شوند؛ این مقادیر به فایل .env می‌روند:

PORT=3000
DATABASE_URL=postgres://localhost:5432/myapp

کد شما این مقادیر را از متغیرهای محیطی می‌خواند (در Node با process.env.PORT). دو عادت حرفه‌ای این مرحله: اول، یک فایل نمونه با نام .env.example بسازید که فقط نام متغیرها را دارد نه مقدارهای واقعی، و آن را commit کنید تا همکاران بدانند چه چیزی لازم است؛ دوم، مطمئن شوید .env در .gitignore هست تا هیچ‌وقت با کلیدهای واقعی به گیت‌هاب نرود. این دو عادت ساده، جلوی رایج‌ترین حادثهٔ امنیتی پروژه‌های تازه‌کار را می‌گیرند.

اجرا، پورت‌ها و رفع اشکال‌های رایج

پروژه معمولاً روی http://localhost:3000 بالا می‌آید (بسته به ابزار ممکن است ۵۱۷۳ یا ۸۰۰۰ باشد). اگر پورت اشغال باشد، خطای EADDRINUSE می‌گیرید که یعنی برنامهٔ قبلی هنوز در حال اجراست؛ ترمینال قبلی را ببندید یا پورت را عوض کنید. با Hot Reload هم آشنا شوید: ابزارهای مدرن با هر ذخیرهٔ فایل، صفحه را تازه می‌کنند و این یعنی چرخهٔ بازخورد چند‌ثانیه‌ای.

چند مشکل پرتکرارِ این مرحله را هم بشناسید تا غافلگیر نشوید: فراموش‌کردن npm install بعد از clone کردن پروژه، اجرای دستور در پوشهٔ اشتباه، و تغییر فایل .env بدون ری‌استارت برنامه. برای مواجههٔ آرام با این خطاها، مهارت‌های دیباگ برای مبتدیان را از دست ندهید؛ خواندن پیام خطا خودش یک مهارت است.

چک‌لیست نهایی محیط آماده

• دستور نسخه (node -v) در ترمینال جواب می‌دهد و نسخه با نیاز پروژه هم‌خوان است.
• npm install (یا pip install -r requirements.txt) بدون خطا تمام می‌شود.
• پروژه اجرا می‌شود و تغییر کد، صفحه را به‌روز می‌کند.
• فایل .env ساخته شده و در .gitignore قرار دارد.
• اولین commit زده شده و پیامش خوانا است.
• می‌دانید لاگ برنامه کجا چاپ می‌شود و خطا را در ترمینال می‌خوانید.

این چک‌لیست را یک بار برای هر پروژهٔ جدید اجرا کنید؛ بعد از سومین تکرار، کل روال زیر ۱۵ دقیقه تمام می‌شود. اگر تازه وارد دنیای کدنویسی هستید، نقشهٔ راه شش‌ماههٔ برنامه‌نویسی جای درست شروع است و راه‌اندازی محیط، دقیقاً همان قدم صفرِ آن مسیر است.