Akademiacademy / vibe-101 / setup-node

Node dan npm

Apa ini

Node.js membolehkan komputer kamu jalankan JavaScript di luar browser.

npm ialah package manager yang datang sekali dengan Node. Ia install libraries yang project kamu perlukan.

Kenapa penting

Setiap project web moden — React, Next.js, Vite, Astro — perlukan Node untuk jalan secara local.

Bila kamu run npm run dev, Node start satu local server kat komputer kamu supaya kamu boleh tengok project dalam browser sebelum di-deploy. Tanpa Node, kamu langsung tak boleh run project.

npm handle dependencies. Bila kamu clone project atau scaffold satu dengan AI, ia akan ada file package.json yang senaraikan semua yang project perlukan. Run npm install untuk download semua tu.

Apa nak buat

Install Node.js

Selalu install versi LTS (Long Term Support). Ia versi stabil yang disyorkan untuk kebanyakan project.

Download dari nodejs.org.

Selepas install, tutup dan buka semula terminal IDE, lepas tu semak:

Terminal command
node -v
npm -v

Patut nampak nombor versi untuk kedua-duanya. Something macam:

Reference

v20.11.0
10.2.4

Kalau tak nampak apa-apa atau ada error, tutup terminal sepenuhnya dan buka semula.

Apa command utama buat

CommandApa ia buat
npm installDownload semua packages yang disenaraikan dalam package.json
npm run devStart local development server
npm run buildBuild versi production project
npm run startRun production build secara local

Kamu akan guna npm install dan npm run dev dalam hampir setiap sesi.

Folder node_modules

Bila kamu run npm install, ia create folder node_modules. Folder ni boleh jadi sangat besar — kadang-kadang ratusan megabyte.

Jangan commit node_modules ke Git. Project yang setup dengan betul akan ada file .gitignore yang exclude ia secara automatik.

Kalau kamu clone project dan ia tak jalan, benda pertama nak cuba ialah:

Terminal command
npm install

Ini download packages yang hilang.

Apa itu package.json

package.json ialah manifest project. Ia senaraikan:

  • Nama dan versi project.
  • Scripts yang boleh kamu run (macam dev, build, start).
  • Packages yang project bergantung pada.

Bila AI generate project untuk kamu, ia akan create package.json. Baca dulu sebelum run apa-apa — ia bagitahu kamu dengan tepat apa yang project guna.

Flow development local

Terminal command
npm install -> npm run dev -> buka browser kat localhost:3000 (atau port yang ditunjukkan)

Terminal akan tunjuk URL local selepas npm run dev start. Biasanya:

Checkpoint

http://localhost:3000

Kekalkan terminal terbuka semasa kamu kerja. Tutup ia akan stop local server.

Mistake biasa

  • Install Node tapi tak restart terminal sebelum semak node -v.
  • Run npm run dev sebelum run npm install — project akan fail.
  • Tutup terminal semasa dev server sedang jalan.
  • Commit node_modules ke Git — selalu semak .gitignore wujud.
  • Install versi Current Node bukannya LTS — kekalkan LTS untuk kestabilan.

Vibe 101 / Checkpoint sekarang

Node dan npm

Sedia untuk stamp - Disimpan dalam browser ini sahaja.

0 daripada 20 checkpoints complete

0 daripada 20 checkpoints complete.