npm के के हो र package.json र लकफाइल के गर्छन्?

Question

Accepted Answer

**npm** (Node Package Manager) तेस्रो-पक्षीय प्याकेजहरू (निर्भरताहरू) स्थापना र प्रबन्ध गर्न र परियोजना स्क्रिप्टहरू चलाउन Node को पूर्वनिर्धारित उपकरण हो। दुई फाइलहरूले एक परियोजना परिभाषित गर्छन्: **`package.json`** (manifest) र **`package-lock.json`** (सटीक निर्भरता रूख)।

## package.json — परियोजना manifest

```json
{
  "name": "my-app",
  "version": "1.0.0",
  "type": "module",
  "scripts": {
    "start": "node server.js",
    "dev": "nodemon server.js",
    "test": "vitest"
  },
  "dependencies": {        // needed at RUNTIME
    "express": "^4.18.0"
  },
  "devDependencies": {     // needed only for DEVELOPMENT (testing, building)
    "vitest": "^1.0.0"
  }
}
```

यो मेटाडेटा, स्क्रिप्टहरू, र निर्भरताहरू रेकर्ड गर्छ। `^4.18.0` एक **semver दायरा** हो — `^` सामञ्जस्यपूर्ण साना/पैच अद्यावधिकहरू अनुमति दिन्छ (4.x.x तर 5.0.0 होइन)।

## लकफाइल — सटीक, पुनरुत्पादनीय स्थापना

```text
package.json says:  express ^4.18.0  (a RANGE — could install 4.18.0 or 4.19.2...)
package-lock.json:  express 4.18.2   (the EXACT version + every nested dependency)
```

लकफाइलले हरेक प्याकेजको **सटीक** संस्करण (transitive निर्भरताहरू सहित) पिन गर्छ जुन स्थापना गरिएको थियो। यो ग्यारान्टी दिन्छ कि सबै टीम — र CI, र उत्पादन — समान निर्भरता रूख पाउँछन्, संस्करण drift बाट "मेरो मेसिनमा काम गर्छ" बग्स रोकेर।

## मुख्य आदेशहरू

```bash
npm install              # install all deps from package.json (updates lockfile)
npm install express      # add a dependency
npm install -D vitest    # add a devDependency
npm ci                   # install EXACTLY from the lockfile (used in CI — fast, strict)
npm run dev              # run a script defined in package.json
```

`npm ci` (`npm install` विरुद्ध) लकफाइलबाट कठोरतापूर्वक स्थापना गर्छ बिना यो संशोधन गरेर — CI/उत्पादन पुनरुत्पादनीयताको लागि सही आदेश।

## लकफाइल कमिट गर्नुहोस्

```text
✓ ALWAYS commit package-lock.json → reproducible installs across the team & CI
```

## यो किन महत्त्वपूर्ण छ

npm र यी दुई फाइलहरू हरेक Node परियोजनाको आधार हुन्।

`package.json` (निर्भरताहरू vs devDependencies, semver दायराहरू, स्क्रिप्टहरू) बुझ्न र विशेष गरी **लकफाइल किन अस्तित्वमा छ** (सम्पूर्ण निर्भरता रूखको निर्धारणीय, पुनरुत्पादनीय स्थापना) आवश्यक छ — लकफाइल कमिट गर्न र CI मा `npm ci` प्रयोग गर्न साथीहरू वा उत्पादनले विभिन्न प्याकेज संस्करणहरू पाएकोले गर्दा सूक्ष्म, कठिन-देबग-गर्न सकिने असफलताहरू रोकिन्छ।