Cara mengatasi masalah dan memperbaiki instalasi Node.js dan npm di Windows dan macOS

Jika Anda pernah mencoba menjalankan proyek dan mendapati bahwa terminal tidak mengenali perintah atau paket global mengalami masalah, jangan panik. Hal ini lebih umum daripada yang Anda kira. Instalasi Node.js dan npm File-file tersebut bisa rusak atau menimbulkan masalah, terutama ketika kita beralih dari satu versi ke versi lain atau ketika izin sistem operasi menjadi rumit.

Untuk menertibkan kekacauan ini, hal pertama yang perlu dipahami adalah Node.js adalah lingkungan yang memungkinkan Anda menjalankan JavaScript di luar browser, sementara npm bertanggung jawab untuk mengelola semua pustaka. Ketika keduanya tidak akur, pendekatan terbaik bukanlah mencoba "menambal" instalasi yang ada, melainkan... lakukan pembersihan menyeluruh dan instal ulang menggunakan alat yang mencegah masalah tersebut terulang kembali di masa mendatang.

Memilih versi yang tepat: LTS atau Versi Terbaru?

Sebelum memulai perbaikan, Anda harus memutuskan jalur mana yang akan diambil. Versi LTS (Dukungan Jangka Panjang) Ini adalah pilihan yang aman; ini adalah pilihan yang tepat jika Anda mencari stabilitas total dalam produksi atau jika Anda baru memulai, karena telah diuji secara luas dan jarang menimbulkan masalah.

Di sisi lain, kami memiliki versi terbaruIni adalah "ujung tombak," tempat fitur-fitur terbaru hadir. Ini bagus untuk bereksperimen atau jika Anda membutuhkan fitur mutakhir dari sebuah framework, tetapi perlu diingat bahwa dukungan lebih singkat dan di sinilah lebih banyak bug cenderung muncul. bug atau ketidakcocokan dengan paket yang lebih lama.

Perbaikan dan Instalasi di Windows 11

Saat Node.js gagal di Windows, seringkali penyebabnya adalah masalah path. Jika Anda menggunakan installer .msi resmi, pastikan opsi [masukkan opsi di sini] dipilih selama proses instalasi. Tambahkan Node ke PATHJika masih tidak berhasil, Anda perlu masuk ke Properti Sistem secara manual dan menambahkan jalur tersebut ke y %AppData%\npm dalam variabel lingkungan pengguna.

Jika Anda lebih menyukai sesuatu yang lebih modern dan bersih, saya sarankan untuk menggunakan... sayapyang sudah terintegrasi ke dalam Windows 10 dan 11. Dengan perintah sederhana seperti Anda bisa menyiapkan semuanya tanpa kesulitan. Ada juga Chocolatey, alternatif yang sangat andal bagi mereka yang menyukai otomatisasi paket melalui baris perintah.

Bagi mereka yang ingin menghindari masalah izin dan mengubah versi tanpa merusak apa pun, solusinya disebut... nvm-windowsIni adalah proyek yang berbeda dari proyek Linux/Mac yang memungkinkan Anda untuk menginstal beberapa versi Node dan beralih di antara versi-versi tersebut dengan mencegah alat-alat global menjadi tidak stabil.

Solusi untuk lingkungan macOS dan Unix

Di Mac, cara yang paling umum adalah menggunakan paket .pkg resmi, tetapi jika Anda ingin meningkatkan alur kerja Anda ke level berikutnya, Homebrew adalah alatnya. definitif. Memungkinkan instalasi Node dengan dan dengan mudah memperbaruinya dengan Namun, terkadang mungkin ada konflik tautan yang dapat diselesaikan dengan perintah tersebut. .

Namun, "cawan suci" sesungguhnya di macOS adalah nvm (Manajer Versi Node)Dengan menginstal Node melalui nvm, file akan tersimpan di folder pengguna Anda dan bukan di direktori sistem yang dibatasi. Ini sepenuhnya menyelesaikan masalah yang ditakuti tersebut. Kesalahan izin EACCES, sehingga menghilangkan kebutuhan untuk menggunakan perintah tersebut. untuk menginstal paket global.

Jika Anda menggunakan Linux (Ubuntu, Debian, atau Fedora), sebaiknya gunakan skrip dari NodeSumber Untuk mendapatkan versi LTS terbaru. Ingatlah bahwa jika Anda menggunakan WSL (Windows Subsystem for Linux), sebaiknya instal Node langsung di dalam distribusi Linux dan jangan mencampur biner Windows dengan biner WSL, karena hal ini dapat menyebabkan masalah. konflik rute cukup menyebalkan.

Penyelesaian masalah kesalahan umum dan perawatan

Jika saat menulis Terminal akan memberi tahu Anda bahwa perintah tersebut tidak dikenali; jangan panik. Biasanya itu berarti bahwa direktori bin global npm File tersebut tidak ada di PATH Anda. Di macOS dan Linux, periksa apakah file Anda ada di PATH. o Konfigurasi nvm dimuat dengan benar saat login, sehingga mencegah localhost menolak untuk terhubung atau kegagalan server lokal serupa.

Untuk menjaga lingkungan yang sehat, tidak cukup hanya memasang dan melupakannya. Implementasi sangat penting. kadang-kadang untuk mendeteksi kerentanan keamanan di departemen Anda. Jika Anda melihat sesuatu sudah ketinggalan zaman, Ini akan memberi tahu Anda paket mana yang memerlukan pembaruan mendesak.

Salah satu trik bagi pengembang adalah dengan menggunakan npxAlih-alih memenuhi sistem Anda dengan instalasi global yang dapat saling bertentangan, npx memungkinkan Anda menjalankan CLI untuk sementara waktu. Selain itu, jika Anda perlu mengelola pnpm atau Yarn, aktifkan paket inti dengan perintah untuk memiliki kendali penuh atas pengelola paket.

Untuk membersihkan sistem sebelum instalasi ulang, di Windows Anda tidak hanya harus menghapus aplikasi dari pengaturan, tetapi juga menghapus folder sisa secara manual di Di Mac, jika Anda menggunakan Homebrew, sebuah biasanya sudah cukup, meskipun membersihkan cache npm dengan Selalu merupakan ide yang baik untuk mencegah kesalahan lama terulang kembali.

Mempertahankan lingkungan pengembangan yang sehat melibatkan selalu memprioritaskan versi LTS, mendelegasikan kontrol versi ke alat seperti NVM atau FNM, dan menghindari penggunaan hak akses administrator untuk menginstal pustaka dengan segala cara. Dengan mengkonfigurasi variabel lingkungan dengan benar dan membersihkan file sementara, kita dapat memastikan bahwa Node.js dan npm berjalan lancar di sistem operasi apa pun.

Artikel terkait:

Perbaiki Localhost Menolak untuk Menghubungkan Kesalahan di Windows

Isaac

Penulis yang bersemangat tentang dunia byte dan teknologi secara umum. Saya suka berbagi ilmu melalui tulisan, dan itulah yang akan saya lakukan di blog ini, menunjukkan kepada Anda semua hal paling menarik tentang gadget, perangkat lunak, perangkat keras, tren teknologi, dan banyak lagi. Tujuan saya adalah membantu Anda menavigasi dunia digital dengan cara yang sederhana dan menghibur.