Jak zainstalować Node.js i npm na Macu

Instalacja Node.js i npm na Macu

Jak zainstalować Node.js i npm na Macu (4 sposoby i naprawy błędów) | We.Inc

Zainstaluj Node.js i npm na Macu za pomocą oficjalnego instalatora, Homebrew, nvm lub fnm. Skopiuj dokładne komendy, sprawdź instalację i napraw błędy EACCES oraz command not found.

npm jest dołączony do Node.js, więc instalując Node, instalujesz też npm. Na Macu możesz użyć instalatora z nodejs.org, uruchomić brew install node albo skorzystać z menedżera wersji, takiego jak nvm lub fnm. Menedżer wersji to najbezpieczniejszy wybór dla programistów, bo eliminuje błędy uprawnień i pozwala przełączać wersje dla każdego projektu.

Porównanie czterech sposobów instalacji

Każdy poradnik o Node.js na Macu wybiera jedną metodę i pomija pozostałe, a potem zostawia Cię z problemem, gdy npm narzeka na uprawnienia. Ta strona zestawia wszystkie cztery obok siebie, z komendami sprawdzonymi w dokumentacji każdego projektu, wyborem metody, który pokazuje tylko potrzebne Ci kroki, oraz narzędziem do naprawy najczęstszych błędów.

Najczęściej zadawane pytania

Czy instalacja Node.js instaluje npm?

Tak. Oficjalny instalator, formuła Homebrew i oba menedżery wersji instalują npm i npx razem z node. Nie musisz osobno pobierać npm.

Którą wersję Node.js zainstalować?

Najnowszą linię LTS. Na nodejs.org w październiku 2026 to v24 (Krypton), a v26 jest wciąż w fazie Current. Frameworki takie jak Vite i Next.js również podają minimalną wersję, więc sprawdź ich dokumentację, jeśli z nich korzystasz.

Co oznacza LTS?

Long Term Support, czyli wsparcie długoterminowe. Wydanie spędza około sześciu miesięcy jako Current, potem przechodzi do Active LTS z poprawkami błędów i bezpieczeństwa, a następnie do Maintenance LTS tylko z krytycznymi poprawkami. Strona Node.js podaje, że od wersji 27 każde wydanie główne będzie LTS, a nie tylko parzyste.

Czy mogę zainstalować nvm przez Homebrew?

README nvm mówi, że instalacja nvm przez Homebrew nie jest wspierana, i prosi o użycie skryptu instalacyjnego. Z kolei fnm opisuje brew install fnm jako normalną ścieżkę instalacji.

Jak odinstalować Node.js zainstalowany przez Homebrew?

Uruchom brew uninstall node. Jeśli przechodzisz na menedżer wersji, zrób to najpierw, aby stary plik binarny nie przesłaniał nowego w Twoim PATH.

Instalator, Homebrew czy menedżer wersji?

Sprawdzanie instalacji

Linie wydań Node.js w październiku 2026

Na podstawie strony z poprzednimi wydaniami Node.js

Codzienne komendy menedżera wersji

Wyświetl zainstalowane wersje, zainstaluj kolejną i przełącz na nią bieżącą powłokę.

Te same zadania w fnm. Z --use-on-cd w konfiguracji powłoki wejście do folderu z plikiem .node-version lub .nvmrc przełącza wersję za Ciebie.

Pobierz z nodejs.org instalator macOS dla wersji LTS i otwórz go.

Przejdź przez instalator, a potem otwórz nowe okno Terminala i sprawdź obie komendy.

Zanim zaczniesz instalować pakiety globalnie, wskaż npm folder, którego jesteś właścicielem, aby nigdy nie potrzebować sudo.

Zainstaluj najnowsze wydanie, które zawiera node, npm i npx.

Albo zostań na linii LTS dzięki formule z wersją. Formuły z wersją są keg-only, więc dodaj linię PATH, którą brew wypisze po instalacji.

Sprawdź wynik w nowym oknie Terminala.

Uruchom skrypt instalacyjny z README nvm (w chwili pisania v0.40.8, a README zawsze pokazuje najnowszą wersję).

Otwórz nowe okno Terminala, a następnie zainstaluj najnowszą wersję LTS i ustaw ją jako domyślną.

Przypnij wersję dla projektu plikiem .nvmrc i przełącz się na nią przez nvm use.

Zainstaluj fnm przez Homebrew.

Dodaj linię konfiguracji powłoki do ~/.zshrc, aby fnm się ładował i przełączał wersje przy zmianie folderu.

Zainstaluj najnowszą wersję LTS i ją sprawdź.

EACCES: permission denied

npm próbował zapisać do folderu systemowego. Nie używaj sudo. Przejdź na nvm lub fnm albo ustaw prefix npm na ~/.local, jak pokazano w krokach instalatora, a potem zainstaluj ponownie pakiet globalny.

command not found: node or npm

Powłoka nie może znaleźć pliku binarnego. Najpierw otwórz nowe okno Terminala. Jeśli nadal nie działa, uruchom which node i sprawdź, czy linia PATH z Homebrew lub linia konfiguracji menedżera wersji jest w ~/.zshrc.

command not found: nvm

nvm to funkcja powłoki ładowana przez linie, które instalator dodaje do Twojego profilu. Otwórz nowe okno albo upewnij się, że ~/.zshrc istnieje przed uruchomieniem instalatora, a potem uruchom go ponownie.

Nieobsługiwany engine lub zła wersja Node.js

Pakiet wymaga innej wersji Node.js niż uruchomiona. Sprawdź node -v, zainstaluj wersję, której potrzebuje projekt, i przypnij ją w .nvmrc lub .node-version.

EADDRINUSE: address already in use

Node.js działa, ale inny proces zajmuje już port. Zajrzyj do poradnika o localhost:3000, gdzie znajdziesz komendy do znalezienia i zatrzymania go.

Oficjalny instalator

Homebrew

Wszystkie metody

Kroki instalacji według metody

Metoda instalacji

Krok {n}

Kopiuj

Naprawa błędów

Wklej komunikat błędu z Terminala

npm ERR! code EACCES

Nie dopasowano żadnego znanego wzorca. Wszystkie rozwiązania są wymienione poniżej.

Znaleziono prawdopodobną przyczynę: {v}

Zacznij za darmo · Bez karty kredytowej

Powiązane: Poradniki

Produkt

Dla kogo

Funkcje

Zasoby

Firma

Mapa strony