اگر بخواهید یک خانه بسازید. آیا از اول شروع به ساخت آجر، سیمان و لولهکشی میکنید؟ مسلماً نه! شما از مصالح آماده، درهای پیشساخته و لولههای استاندارد استفاده میکنید. در این مطلب به بررسی npm موتور محرک دنیای جاوا اسکریپت میپردازیم.
برنامهنویسی مدرن هم دقیقاً همینطور است. npm همان بازار بزرگ مصالح ساختمانی دنیای جاوااسکریپت است که به شما اجازه میدهد به جای اختراع دوباره چرخ، از قطعات آماده و تستشده دیگران استفاده کنید.
اگر به تازگی وارد دنیای جاوااسکریپت شدهاید یا اسم npm را شنیدهاید اما دقیقاً نمیدانید چیست، این مقاله برای شماست. ما قرار است بدون اصطلاحات پیچیده، دنیای جذاب npm را با هم کشف کنیم.
npm چیست؟
npm مخفف Node Package Manager است. اما بیایید آن را به زبان خودمانی تعریف کنیم:
npm سه چیز است:
۱. یک فروشگاه بزرگ آنلاین: بزرگترین فروشگاه قطعات آماده کد جاوااسکریپت در دنیا! میلیونها قطعه کد رایگان (پکیج یا بسته) که دیگران نوشتهاند و شما میتوانید دانلود و استفاده کنید.
۲. یک مدیر کارکشته: وقتی دهها قطعه از این فروشگاه برای پروژهتان میخرید، این مدیر (که همان خط فرمان npm است) مراقب است که همه قطعات با هم جور باشند، بهروز باشند و در جای درست نصب شوند.
۳. یک دفتر ثبت: یک دفترچه (فایل package.json) که مشخصات تمام مصالح پروژه شما را نگه میدارد تا اگر همکارتان خواست روی پروژه کار کند، دقیقاً همان مصالح شما را استفاده کند.
مثال: میخواهید یک اسلایدر تصویر زیبا برای وبسایتتان بسازید. دو راه دارید:
راه سخت: ۱۰۰۰ خط کد بنویسید، برای همه مرورگرها تست کنید، مشکلات موبایل را رفع کنید… (حداقل ۳ روز کار).
راه npm: در ترمینال تایپ کنید: npm install swiper. کمتر از ۱۰ ثانیه بعد، یک اسلایدر حرفهای که هزاران نفر استفاده کردهاند، در پروژه شما نصب شده و آماده استفاده است!
npm چطور کار میکند؟
برای درک npm، باید با سه عضو اصلی آن آشنا شویم:
۱. وبسایت npmjs.com (فروشگاه اصلی)
آدرسش است: [https://www.npmjs.com/](https://www.npmjs.com/)
میتوانید بین میلیونها پکیج جستجو کنید (مثلاً “calendar” برای تقویم یا “chart” برای نمودار).
برای هر پکیج، توضیح، راهنما، آمار دانلود و نظرات کاربران را میبینید. مثل دیجیکالای کد!
۲. خط فرمان npm (CLI) دستیار شخصی شما
این همان ابزار جادویی است که در ترمینال یا CMD از آن استفاده میکنید.
با دستوراتی ساده مثل npm install یا npm start کنترل پروژه را در دست میگیرید.
بعد از نصب Node.js، این ابزار به طور خودکار روی سیستم شما نصب میشود.
۳. رجیستری (انبار مرکزی)
یک پایگاهداده عظیم در سرورهای npm که تمام پکیجها و نسخههای آنها را نگهداری میکند.
وقتی شما npm install میزنید، خط فرمان به این انبار مرکزی وصل میشود و پکیج را دانلود میکند.
فایل package.json؛ شناسنامه پروژه شما
این مهمترین فایل در هر پروژهای است که از npm استفاده میکند. اگر پروژه شما یک نفر باشد، package.json کارت ملی آن است.
چطور ساخته میشود؟
با یک دستور ساده:
npm init
سپس چند سوال ساده از شما میپرسد (نام پروژه، توضیح، نویسنده و…) و این فایل را ایجاد میکند.
چه چیزهایی داخلش است؟
json
{
"name": "myawesomeproject",
"version": "1.0.0",
"description": "این یک پروژه عالی برای تست npm است",
"main": "index.js",
"scripts": {
"start": "node index.js",
"dev": "nodemon index.js"
},
"dependencies": {
"express": "^4.18.2"
},
"devDependencies": {
"nodemon": "^3.0.1"
}
}
name & version: اسم و نسخه پروژه. خیلی مهم برای وقتی که بخواهید خود پروژه را به عنوان یک پکیج منتشر کنید.
scripts: دکمههای میانبر پروژه شما! به جای تایپ دستورات طولانی، یک نام ساده تعریف میکنید.
مثال: به جای node index.js، فقط npm start را تایپ میکنید.
npm run dev هم ممکن است سرور توسعه را با ابزاری مثل nodemon راهبیندازد که با هر تغییر کد، خودش ریاستارت میشود.
dependencies: لوازم اصلی پروژه. پکیجهایی که برای اجرای پروژه ضروری هستند (مثلاً فریمورک Express برای سرور).
devDependencies: ابزارهای کارگاهی. پکیجهایی که فقط موقع توسعه نیاز دارید (مثلاً nodemon برای ریاستارت خودکار، یا eslint برای بررسی کیفیت کد). موقع انتشار پروژه، اینها نصب نمیشوند.
دستورات جادویی npm که هر توسعهدهندهای باید بلد باشد
۱. نصب یک پکیج (خریدن از فروشگاه)
bash
npm install axios
چه میکند؟ آخرین نسخه پکیج axios (برای درخواستهای HTTP) را دانلود و نصب میکند.
کجا ذخیره میشود؟ در پوشهای به نام node_modules که به طور خودکار ساخته میشود. هرگز این پوشه را دستی ویرایش نکنید!
چطور ثبت میشود؟ نام و نسخه پکیج به بخش dependencies در package.json اضافه میشود.
نصب به عنوان ابزار توسعه:
bash
npm install savedev prettier
یا کوتاهشده:
bash
npm i D prettier
پکیج prettier (برای فرمتدهی خودکار کد) را فقط به عنوان ابزار توسعه نصب میکند و در devDependencies ثبت میکند.
۲. نصب همهچیز از نو
فرض کنید پروژه را از گیتهاب کلون کردهاید. پوشه node_modules وجود ندارد. فقط این دستور را بزنید:
bash
npm install
چه میکند؟ به فایل package.json نگاه میکند و تمامی پکیجهای لیست شده در dependencies و devDependencies را دانلود و نصب میکند. مثل این است که با یک لیست خرید به فروشگاه بروید و همه اقلام را بخرید.
۳. بهروزرسانی پکیجها
bash
npm update
تمام پکیجهای نصبشده را (با رعایت قوانین نسخهبندی) به جدیدترین نسخه سازگار بهروز میکند.
۴. حذف یک پکیج
bash
npm uninstall axios
پکیج axios را پاک میکند و نامش را از package.json حذف میکند.
۵. اجرای اسکریپتها (فشردن دکمه میانبر)
bash
npm start
npm run dev
npm test
دستورات از پیش تعریفشده در بخش scripts فایل package.json را اجرا میکند.
packagelock.jsonچیست؟
این فایل خودکار توسط npm ایجاد میشود. کارش چیست؟
مشکل: در package.json ممکن است نسخه یک پکیج به صورت ^4.18.2 نوشته شده باشد (یعنی “هر نسخهای از نسل ۴ که بالاتر از ۱۸.۲ باشد”). ممکن است روی سیستم شما نسخه ۴.۱۸.۵ نصب شود و روی سیستم همکارتان ۴.۲۰.۰. ممکن است بین این دو نسخه تغییرات شکستخوری وجود داشته باشد!
راهحل: packagelock.json عکس فوری و دقیق از درخت وابستگیهای پروژه شما در لحظه نصب است. دقیقاً مشخص میکند هر پکیج، کدام نسخهاش نصب شده.
نتیجه: اگر شما npm install بزنید و همکارتان هم روی پروژهای که packagelock.json دارد npm install بزند، عیناً همان نسخهها نصب میشود. تضمین سازگاری کامل.
نکته طلایی: فایل packagelock.json را همیشه به مخزن گیت (Git) اضافه کنید. آن را نادیده نگیرید!
npx، برادر کوچک و کارکشته npm
گاهی میخواهید یک ابزار را فقط یک بار اجرا کنید، نه اینکه آن را نصب کنید. اینجاست که npx به کمک میآید.
مثال کلاسیک: ایجاد یک پروژه React جدید
قدیم میگفتند:
bash
npm install g createreactapp اول نصب گلوبال
createreactapp myapp بعد اجرا
حالا با npx فقط میگویید:
bash
npx createreactapp myapp
چه میکند؟ آخرین نسخه createreactapp را به صورت موقت دانلود میکند، اجرا میکند و بعد از اتمام کار، پاکش میکند! مثل اجاره کردن به جای خریدن.
نسخهبندی معنایی (SemVer)؛ زبان مشترک npm
پکیجها از قاعده MAJOR.MINOR.PATCH پیروی میکنند (مثلاً ۱۶.۱۳.۱).
پچ (1): وقتی عدد سمت راست تغییر کند (۱۶.۱۳.۱ → ۱۶.۱۳.۲). یعنی رفع باگ کوچک و سازگار عقبگرد. ایمن برای آپدیت.
مینور (13): وقتی عدد وسط تغییر کند (۱۶.۱۳.۱ → ۱۶.۱۴.۰). یعنی افزودن قابلیت جدید اما به روشی سازگار با نسخه قبلی. معمولاً ایمن است.
مَیجر (16): وقتی عدد سمت چپ تغییر کند (۱۶.۱۳.۱ → ۱۷.۰.۰). یعنی تغییرات بزرگ و احتمالاً ناسازگار. باید حواستان باشد!
در package.json مینویسید:
"express": "4.18.2" → دقیقاً همین نسخه.
"express": "^4.18.2" → آخرین نسخهای که میجر آن 4 است (مثلاً 4.20.0). (پیشفرض npm).
"express": "~4.18.2" → آخرین نسخهای که میجر و مینور آن 4.18 است (مثلاً 4.18.5).
چرا npm اینقدر مهم است؟
۱. سرعت دیوانهوار: چرا یک ماه برای چیزی وقت بگذارید که در ۵ دقیقه میتوانید دانلود کنید؟
۲. کیفیت اثباتشده: پکیجهای محبوب توسط هزاران توسعهدهنده استفاده و باگهایشان رفع شده است.
۳. اجتماع عظیم: اگر به مشکلی برخوردید، به احتمال زیاد کسی قبلاً همان مشکل را داشته و راهحلش را در اینترنت گذاشته است.
۴. استاندارد صنعتی: امروزه تقریباً هیچ پروژه جدی جاوااسکریپتی بدون npm (یا رقیبش مثل yarn یا pnpm) وجود ندارد.
جمع بندی
npm در ابتدا ممکن است پیچیده به نظر برسد، اما در واقع بسیار ساده و شهودی است. شروع کنید. یک پروژه تستی بسازید (npm init). یک پکیج ساده نصب کنید (npm install chalk). یک اسکریپت برای خودتان بنویسید.
به یاد داشته باشید: همه توسعهدهندگان بزرگ روزی مبتدی بودند. قدرت دنیای متنباز و ابزاری مثل npm در همین است که شما میتوانید بر شانههای غولها بایستید و چیزهای خارقالعاده بسازید، بدون اینکه مجبور باشید از صفر شروع کنید.
پس ترمینال را باز کنید و بزنید npm init. سفر شما تازه آغاز شده است
