npm 11: راهنمای جامع مدیریت بسته در Node.js - از مبتدی تا حرفه‌ای ۲۰۲۶

مقدمه: داستان npm - از یک ایده تا استاندارد صنعت

در سال ۲۰۰۹، زمانی که Ryan Dahl اولین نسخه Node.js را معرفی کرد، یک چالش اساسی وجود داشت: چگونه می‌توان کتابخانه‌ها و ماژول‌های جاوااسکریپت را به سادگی مدیریت و به اشتراک گذاشت؟ Isaac Schlueter با ایجاد npm پاسخ این نیاز را داد. npm به سرعت به مدیر بسته پیش‌فرض Node.js تبدیل شد و انقلابی در اکوسیستم جاوااسکریپت ایجاد کرد [citation:6].

یادم می‌آید اولین بار در سال ۲۰۱۶ با npm کار کردم. نصب Express با یک خط فرمان ساده npm install express تجربه‌ای جادویی بود. امروز پس از سال‌ها توسعه و تدریس در درخت کد، npm به یکی از ضروری‌ترین ابزارهای هر توسعه‌دهنده وب تبدیل شده است.

۱.۱ تاریخچه نسخه‌های npm

بخش اول: npm چیست و چرا به آن نیاز داریم؟

بخش دوم: نصب و شروع کار

۲.۱ نصب npm

npm به صورت خودکار با Node.js نصب می‌شود. برای نصب یا به‌روزرسانی [citation:1]:

# بررسی نسخه npm
npm -v

# نصب آخرین نسخه npm
npm install -g npm@latest

# نصب نسخه خاص
npm install -g npm@11.0.0

۲.۲ ایجاد پروژه جدید و فایل package.json

# ایجاد پوشه پروژه
mkdir my-project
cd my-project

# مقداردهی اولیه با پرسش‌های تعاملی
npm init

# مقداردهی با مقادیر پیش‌فرض
npm init -y

{
    "name": "my-project",
    "version": "1.0.0",
    "description": "یک پروژه نمونه",
    "main": "index.js",
    "scripts": {
        "test": "echo \"Error: no test specified\" && exit 1"
    },
    "keywords": [],
    "author": "",
    "license": "ISC"
}

بخش سوم: مدیریت بسته‌ها با npm

۳.۱ نصب بسته‌ها

۳.۲ تفاوت dependencies و devDependencies

• dependencies: بسته‌های مورد نیاز در زمان اجرا (مثل express، react)
• devDependencies: بسته‌های مورد نیاز فقط در زمان توسعه (مثل jest، eslint، webpack) [citation:4]

۳.۳ به‌روزرسانی و حذف بسته‌ها

# به‌روزرسانی همه بسته‌ها
npm update

# به‌روزرسانی یک بسته خاص
npm update package-name

# حذف بسته
npm uninstall package-name [citation:1]

بخش چهارم: Semantic Versioning (SemVer)

"react": "18.3.1"      // نسخه دقیق
"react": "^18.3.1"     // هر نسخه MAJOR ثابت، MINOR و PATCH جدیدتر (۱۸.x.x)
"react": "~18.3.1"     // MAJOR و MINOR ثابت، PATCH جدیدتر (۱۸.۳.x)
"react": ">=18.0.0"    // هر نسخه مساوی یا بزرگتر از ۱۸
"react": "latest"      // آخرین نسخه موجود

بخش پنجم: فایل package-lock.json

بخش ششم: اسکریپت‌های npm (npm scripts)

{
    "scripts": {
        "start": "node index.js",
        "dev": "nodemon index.js",
        "build": "webpack --mode production",
        "test": "jest",
        "lint": "eslint .",
        "prestart": "echo \"در حال شروع...\"",
        "poststart": "echo \"شروع شد!\""
    }
}

npm start        # اسکریپت start (ویژه)
npm run dev      # اسکریپت‌های دیگر با run
npm run build
npm test         # اسکریپت test (ویژه)

بخش هفتم: امنیت در npm

۷.۱ npm audit و بررسی امنیتی

# بررسی آسیب‌پذیری‌های امنیتی
npm audit

# رفع خودکار آسیب‌پذیری‌ها
npm audit fix

# بررسی دقیق
npm audit --json

۷.۲ Trusted Publishing - روش مدرن انتشار بسته

۷.۳ احراز هویت دو مرحله‌ای (2FA)

# فعال‌سازی 2FA برای حساب کاربری
npm profile enable-2fa

# فعال‌سازی 2FA برای انتشار بسته
npm profile enable-2fa --auth-type=web

بخش هشتم: npm Workspaces

my-monorepo/
├── package.json
├── packages/
│   ├── ui/
│   │   └── package.json
│   ├── utils/
│   │   └── package.json
│   └── server/
│       └── package.json
└── apps/
    ├── web/
    │   └── package.json
    └── mobile/
        └── package.json

{
    "name": "my-monorepo",
    "workspaces": ["packages/*", "apps/*"]
}

# نصب وابستگی در همه workspaceها
npm install

# اجرای اسکریپت در یک workspace خاص
npm run test -w packages/ui

# اجرای اسکریپت در همه workspaceها
npm run test --workspaces

بخش نهم: npm در مقابل رقبا (Yarn و pnpm)

۹.۱ مقایسه کلی

۹.۲ مقایسه دستورات [citation:6]

۹.۳ چه زمانی از کدام استفاده کنیم؟ [citation:8][citation:9]

• npm: پروژه‌های کوچک و متوسط، تیم‌هایی که به سادگی و سازگاری نیاز دارند
• pnpm: پروژه‌های بزرگ، monorepoها، وقتی فضای دیسک مهم است
• Yarn: پروژه‌هایی که به قابلیت PnP (Plug'n'Play) نیاز دارند

بخش دهم: ساخت و انتشار بسته npm

mkdir my-package
cd my-package
npm init -y

// index.js
module.exports = function greet(name) {
    return `سلام ${name}، به بسته من خوش آمدید!`;
}

npm login

npm publish

# تغییر نسخه در package.json
npm version patch  # برای PATCH
npm version minor  # برای MINOR
npm version major  # برای MAJOR

# انتشار نسخه جدید
npm publish

بخش یازدهم: npx - اجرای بسته بدون نصب

# اجرای create-react-app بدون نصب
npx create-react-app my-app

# اجرای یک بسته خاص
npx cowsay "سلام دنیا"

# اجرای یک نسخه خاص
npx eslint@8.0.0 .

بخش دوازدهم: بازار کار و فرصت‌های شغلی

نتیجه‌گیری: چرا npm؟