Cara menyelesaikan masalah dan membaiki pemasangan Node.js dan npm pada Windows dan macOS

Jika anda pernah cuba melancarkan projek dan mendapati terminal tidak mengenali arahan atau pakej global telah menjadi kucar-kacir, jangan panik. Ia lebih biasa daripada yang anda sangkakan. Pemasangan Node.js dan npm Ia menjadi rosak atau menyebabkan masalah, terutamanya apabila kita beralih dari satu versi ke versi yang lain atau apabila kebenaran sistem pengendalian menjadi rewel.

Untuk menertibkan kekacauan ini, perkara pertama yang perlu difahami ialah Node.js ialah persekitaran yang membolehkan anda menjalankan JavaScript di luar pelayar, manakala npm bertanggungjawab untuk mengurus semua pustaka. Apabila kedua-duanya tidak serasi, pendekatan terbaik adalah dengan tidak cuba "menampal" pemasangan semasa, tetapi sebaliknya gunakan pembersihan yang mendalam dan pasang semula menggunakan alat yang menghalang masalah daripada berulang pada masa hadapan.

Memilih versi yang betul: LTS atau Semasa?

Sebelum memulakan pembaikan, anda perlu memutuskan laluan mana yang hendak diambil. Versi LTS (Sokongan Jangka Panjang) Ia adalah pilihan yang selamat; ia adalah yang harus anda gunakan jika anda mencari kestabilan sepenuhnya dalam pengeluaran atau jika anda baru bermula, kerana ia telah diuji secara meluas dan jarang menyebabkan kejutan.

Sebaliknya, kami mempunyai versi Arus ElektrikDi sinilah "canggih", ciri-ciri terbaharu muncul. Ia bagus untuk bereksperimen atau jika anda memerlukan ciri canggih daripada rangka kerja, tetapi perlu diingat bahawa sokongan adalah lebih pendek dan di sinilah lebih banyak pepijat cenderung muncul. pepijat atau ketidakserasian dengan pakej yang lebih lama.

Pembaikan dan Pemasangan dalam Windows 11

Apabila Node.js gagal pada Windows, ia selalunya disebabkan oleh isu laluan. Jika anda menggunakan pemasang .msi rasmi, pastikan pilihan untuk [masukkan pilihan di sini] telah dipilih semasa proses tersebut. tambah Nod ke PATHJika ia masih tidak berfungsi, anda perlu pergi ke System Properties secara manual dan menambah laluan ke y %AppData%\npm dalam pembolehubah persekitaran pengguna.

Jika anda lebih suka sesuatu yang lebih moden dan bersih, saya cadangkan menggunakan sayapyang telah disepadukan ke dalam Windows 10 dan 11. Dengan arahan mudah seperti Anda boleh menyediakan semuanya tanpa sebarang komplikasi. Terdapat juga Chocolatey, alternatif yang sangat mantap bagi mereka yang menyukai automasi pakej melalui baris arahan.

Bagi mereka yang ingin mengelakkan masalah kebenaran dan menukar versi tanpa merosakkan apa-apa, penyelesaiannya dipanggil nvm-windowsIa merupakan projek yang berbeza daripada projek Linux/Mac yang membolehkan anda memasang berbilang versi Node dan bertukar antara satu sama lain dengan mencegah alat global daripada menjadi tidak stabil.

Penyelesaian untuk persekitaran macOS dan Unix

Pada Mac, cara paling biasa adalah dengan menggunakan pakej .pkg rasmi, tetapi jika anda ingin meningkatkan aliran kerja anda ke tahap seterusnya, Homebrew ialah alatnya muktamad. Membolehkan anda memasang Node dengan dan sentiasa mengemas kininya dengan mudah Walau bagaimanapun, kadangkala mungkin terdapat konflik pautan yang diselesaikan dengan arahan .

Walau bagaimanapun, "impian suci" sebenar dalam macOS ialah nvm (Pengurus Versi Nod)Dengan memasang Node melalui nvm, fail disimpan dalam folder pengguna anda dan bukan dalam direktori sistem terhad. Ini menyelesaikan sepenuhnya masalah yang ditakuti. Ralat kebenaran EACCES, menghapuskan keperluan untuk menggunakan arahan untuk memasang pakej global.

Jika anda menggunakan Linux (Ubuntu, Debian atau Fedora), adalah lebih baik menggunakan skrip Sumber Node Untuk mendapatkan versi LTS yang dikemas kini. Ingat bahawa jika anda menggunakan WSL (Windows Subsystem for Linux), sebaiknya pasang Node terus dalam pengedaran Linux dan jangan campurkan binari Windows dengan binari WSL, kerana ini boleh menyebabkan masalah. konflik laluan cukup menjengkelkan.

Menyelesaikan masalah ralat dan penyelenggaraan yang biasa

Jika semasa menulis Terminal akan memberitahu anda bahawa arahan itu tidak dikenali; jangan panik. Ia biasanya bermaksud bahawa direktori bin global npm Ia tiada dalam PATH anda. Pada macOS dan Linux, pastikan fail anda o memuatkan konfigurasi nvm dengan betul semasa log masuk, sekali gus menghalang localhost enggan menyambung atau kegagalan pelayan setempat yang serupa.

Untuk mengekalkan persekitaran yang sihat, tidak cukup hanya memasang dan melupakannya. Pelaksanaan adalah penting. sekali-sekala untuk mengesan kelemahan keselamatan di jabatan anda. Jika anda melihat sesuatu itu ketinggalan zaman, Ia akan memberitahu anda pakej mana yang memerlukan kemas kini segera.

Satu helah untuk pembangun adalah dengan menggunakan npxDaripada mengisi sistem anda dengan pemasangan global yang boleh berkonflik antara satu sama lain, npx membolehkan anda menjalankan CLI buat sementara waktu. Selain itu, jika anda perlu mengurus pnpm atau Yarn, dayakan Pek teras dengan arahan untuk mempunyai kawalan penuh ke atas pengurus pakej.

Untuk memastikan sistem bersih sebelum pemasangan semula, dalam Windows, anda bukan sahaja mesti memadam aplikasi daripada tetapan, tetapi juga memadam folder baki secara manual dalam Pada Mac, jika anda menggunakan Homebrew, biasanya mencukupi, walaupun membersihkan cache npm dengan Adalah idea yang baik untuk mengelakkan kesilapan lama daripada berulang.

Mengekalkan persekitaran pembangunan yang sihat melibatkan sentiasa mengutamakan versi LTS, mendelegasikan kawalan versi kepada alatan seperti NVM atau FNM, dan mengelakkan penggunaan keistimewaan pentadbir untuk memasang pustaka dengan apa jua cara. Dengan mengkonfigurasi pembolehubah persekitaran dan membersihkan fail sementara dengan betul, kita boleh memastikan Node.js dan npm berjalan lancar pada mana-mana sistem pengendalian.

Artikel berkaitan:

Betulkan Localhost Enggan Menyambung Ralat dalam Windows

Ishak

Penulis yang bersemangat tentang dunia bait dan teknologi secara umum. Saya suka berkongsi pengetahuan saya melalui penulisan, dan itulah yang akan saya lakukan dalam blog ini, menunjukkan kepada anda semua perkara yang paling menarik tentang alat, perisian, perkakasan, trend teknologi dan banyak lagi. Matlamat saya adalah untuk membantu anda mengemudi dunia digital dengan cara yang mudah dan menghiburkan.