Builder Toolkit · 03 / 11

Node dan npm

Fahami apa yang Node run, apa yang npm install, dan fungsi sebenar package.json, node_modules, dan lockfile.

Node dan npm

Apa ini

Node ialah program yang menjalankan JavaScript pada komputer anda, bukan di dalam halaman web.

npm datang bersama Node dan ia download code yang orang lain sudah tulis, supaya anda tidak perlu tulis sendiri.

Satu idea utama

Node ialah enjin. npm ialah kedai alat ganti. package.json ialah senarai alat ganti untuk project anda.

Kenapa penting

Anda sudah pun taip npm install dan npm run dev. Command itu berjaya, tetapi tiada siapa terangkan apa yang berlaku.

Itu okay sehingga sesuatu rosak. Bila build gagal dengan error package, atau project jalan di laptop anda tetapi tidak di laptop kawan, fix itu jelas kalau anda tahu apa benda ini semua, dan mustahil diteka kalau anda tidak tahu.

Apa nak buat

Sahkan apa yang sudah dipasang

Run kedua-dua ini:

Terminal command

node -v
npm -v

Swipe sideways if a command is long.

Setiap satu patut cetak nombor versi seperti v22.11.0. Kalau salah satu kata command tidak dijumpai, Node belum dipasang atau terminal dibuka sebelum ia dipasang.

Restart selepas install

Terminal yang dibuka sebelum anda install Node masih pakai setting lama. Tutup dan buka yang baharu, kalau tidak semakan versi terus gagal walaupun install berjaya.

Cara install Node untuk kelas live ada langkah demi langkah dalam Setup Gate KDBM Lite. Halaman ini terangkan apa yang anda pasang dan kenapa.

Kenali empat bahagian

Bahagian	Apa ia sebenarnya	Apa anda buat dengannya
Node	Menjalankan JavaScript di luar browser	Tiada secara langsung. Command lain yang guna.
npm	Download dan urus package	`npm install`, `npm run`
`package.json`	Senarai alat ganti dan senarai command project	Baca untuk tahu apa yang project guna.
`node_modules`	Package yang sudah di-download	Jangan edit. Jangan upload.
`package-lock.json`	Rekod versi tepat yang dipasang	Simpan. Commit. Jangan edit manual.

Fahami dua command yang anda sudah guna

npm install baca package.json, download setiap package yang disenaraikan ke dalam node_modules, dan tulis versi tepatnya ke dalam package-lock.json.

npm run dev cari bahagian scripts dalam package.json dan jalankan apa sahaja yang dev ditakrifkan sebagai. Command itu bukan sebahagian daripada npm. Penulis project yang pilih.

Buka package.json anda sendiri dan lihat scripts. Setiap command yang project anda sokong ada di situ.

Buat sekarang

Buka package.json dalam editor dan baca blok scripts dengan kuat. Itu sahaja run command yang project anda ada.

Check sendiri

node -v dan npm -v kedua-duanya cetak versi.
Saya boleh cari package.json dalam project saya.
Saya boleh sebut satu script yang tersenarai di dalamnya.
Saya tahu node_modules di-download, bukan saya yang tulis.

Tahu bila nak padam node_modules

Kalau install berkelakuan pelik, reset standardnya ialah padam package yang sudah di-download dan install semula:

Terminal command

rm -rf node_modules
npm install

Swipe sideways if a command is long.

Di Windows tanpa terminal gaya Unix, padam folder node_modules dalam file explorer, kemudian run npm install.

Ini selamat. Semua dalam node_modules sentiasa boleh di-download semula daripada package.json. Itulah sebabnya ia tidak sekali-kali perlu di-upload ke GitHub.

Kalau install gagal

Baca baris merah pertama, bukan yang terakhir. Kebanyakan kegagalan npm menyebut masalah sebenar di bahagian atas, kemudian cetak berhalaman-halaman kesan sampingan. Ikut Baca error.

Common mistakes

Edit file dalam node_modules. Perubahan anda hilang pada install seterusnya.
Upload node_modules ke GitHub. Ia besar dan langsung tidak perlu.
Padam package-lock.json untuk baiki error. Itu buang rekod apa yang pernah berjaya.
Run npm run dev dalam folder salah dan baca errornya sebagai masalah code.
Anggap npm run dev command universal. Ia hanya wujud kalau project takrifkannya.

Next step

Project anda jalan di local. Sekarang keluarkan ia dari laptop dengan Asas GitHub.