Jak nainstalovat a používat npm na Ubuntu: Kompletní průvodce pro začátečníky (2025)

1. Úvod

Proč používat npm na Ubuntu?

Jedním z nezbytných nástrojů pro vývoj jak na frontendu, tak na backendu je npm (Node Package Manager). Široce používán jako výchozí správce balíčků pro Node.js, npm usnadňuje instalaci a správu JavaScriptových knihoven a nástrojů.

Používání npm na Ubuntu využívá rychlost Linuxu a flexibilní správu balíčků, což výrazně zvyšuje efektivitu vývoje. Ubuntu je mezi vývojáři oblíbená distribuce, používá se pro vše od serverových operací po lokální vývojová prostředí.

Při práci s frameworky založenými na Node.js, jako jsou Vue.js, React nebo Next.js, je běžné používat npm pro správu balíčků. Nastavení těchto nástrojů na Ubuntu poskytuje stabilnější vývojové prostředí s méně problémy ve srovnání s Windows nebo macOS.

Účel tohoto článku

Tento článek vás provede instalací npm na Ubuntu a osvojením si jeho základního používání. Je zvláště užitečný pro následující čtenáře:

• Vývojáře, kteří jsou v Ubuntu noví
• Každého, kdo má pot s nastavením Node.js a npm
• Ty, kteří se chtějí naučit používat npm strukturovaným způsobem

Probereme několik instalačních metod a probereme výhody i nevýhody každé z nich. Tak se zaměříme na časté chyby, tipy na odstraňování problémů a sbírku užitečných příkazů, které vám pomohou hladce začít pracovat s npm na Ubuntu.

2. Jak nainstalovat Node.js a npm na Ubuntu

Abyste mohli na Ubuntu používat npm, musíte nejprve nainstalovat Node.js. Důvod je ten, že npm je součástí Node.js, takže instalace Node.js automaticky zpřístupní npm.

V této sekci projdeme tři hlavní metody instalace Node.js a npm na Ubuntu. Každá metoda má své specifické vlastnosti, proto je důležité vybrat tu, která nejlépe odpovídá vašemu stylu vývoje a cílům.

Metoda 1: Použití oficiálního repozitáře Ubuntu

Kroky

Node.js je dostupný v výchozích repozitářích Ubuntu. Tato metoda je nejjednodušší a nejvhodnější pro začátečníky.

sudo apt update
sudo apt install nodejs npm

Po instalaci můžete zkontrolovat nainstalované verze pomocí následujících příkazů:

node -v
npm -v

Výhody

• Jednoduché příkazy, snadno sledovatelné
• Bezpečná a stabilní verze poskytovaná distribucí

Nevýhody

• Verze Node.js/npm může být zastaralá, takže některé novější funkce nemusí být k dispozici

Metoda 2: Použití NodeSource PPA

Novější verze Node.js a npm můžete získat pomocí repozitáře NodeSource, který úzce spolupracuje s oficiální podporou Node.js.

Kroky (příklad: instalace Node.js 18.x)

curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install -y nodejs

npm bude nainstalován automaticky spolu s Node.js.

Výhody

• Přístup k novějším, ale stabilním verzím
• Jednoduchá instalace a dobrá kompatibilita s Ubuntu

Nevýhody

• Stejně jako u jakéhokoli PPA může být nutné ručně spravovat systémové závislosti

Metoda 3: Použití nvm (Node Version Manager)

Pokud chcete přepínat mezi více verzemi Node.js, je nvm nejflexibilnější a nejpohodlnější metoda.

Kroky

Nejprve nainstalujte nvm:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

Poté načtěte znovu svůj shell a nainstalujte Node.js pomocí nvm:

source ~/.bashrc  # or ~/.zshrc
nvm install 18
nvm use 18

npm bude také automaticky nainstalován spolu s Node.js.

Výhody

• Snadné přepínání mezi různými verzemi Node.js
• Nastavení verze per projekt pro lepší kompatibilitu
• Nezasahuje do systémového prostředí, je bezpečné používat

Nevýhody

• O něco složitější nastavení ve srovnání s ostatními metodami
• Je potřeba upravit konfigurační soubor svého shellu

Kterou metodu si vybrat?

Pokud plánujete používat npm na Ubuntu dlouhodobě, nvm je nejvíce doporučená metoda. Pokud však chcete rychle začít, NodeSource PPA je také solidní volba.

3. Základní používání npm

Jakmile jste na Ubuntu nastavili Node.js a npm, dalším krokem je začít spravovat balíčky pomocí npm. npm je výkonný nástroj používaný k instalaci, aktualizaci a odstranění balíčků JavaScriptu.

V této sekci představíme nejběžněji používané příkazy npm, které vám pomohou začít.

Instalace balíčků

Lokální instalace

Balíčky, které se používají pouze v rámci specifického projektu, by měly být instalovány lokálně. Toto je standardní přístup a instaluje balíček do adresáře node_modules, přičemž detaily jsou zaznamenány v package.json.

npm install package-name

Příklad: Instalace axios

npm install axios

Pouze skripty v rámci stejného projektu budou moci tento balíček používat.

Globální instalace

Nástroje, které se používají na celém systému, jako například CLI aplikace, by měly být instalovány globálně.

npm install -g package-name

Příklad: Globální instalace http-server

sudo npm install -g http-server

Na Ubuntu můžete potřebovat použít sudo, když používáte volbu -g.

Odstraňování balíčků

Pokud balíček již nepotřebujete, můžete ho odstranit pomocí následujících příkazů.

Odstranění lokálního balíčku

npm uninstall package-name

Odstranění globálního balíčku

sudo npm uninstall -g package-name

Aktualizace balíčků

K aktualizaci balíčků na nejnovější verzi můžete použít tyto příkazy.

Aktualizace specifického balíčku

npm update package-name

Aktualizace všech závislostí najednou

npm update

Poznámka: Toto aktualizuje balíčky pouze v rozsahu verzí specifikovaném v package.json, takže vždy dvojitě zkontrolujte čísla verzí.

Instalace vývojových balíčků (–save-dev)

Balíčky používané pouze ve vývojových prostředích – jako například nástroje pro testování nebo sestavování – by měly být instalovány s volbou --save-dev.

npm install --save-dev package-name

Příklad: Instalace jest jako vývojové závislosti

npm install --save-dev jest

Toto přidá balíček do sekce devDependencies vašeho package.json.

Zobrazení nainstalovaných balíčků

Seznam lokálních balíčků

npm list

Seznam globálních balíčků

npm list -g --depth=0

Specifikováním --depth=0 jsou zobrazeny pouze balíčky na nejvyšší úrovni, což usnadňuje čtení seznamu.

Správa závislostí projektu s package.json

Soubor package.json, umístěný v kořeni vašeho projektu, hraje klíčovou roli v workflow npm. Ukládá názvy balíčků, verze a vlastní skripty, slouží jako konfigurační soubor projektu.

Můžete vytvořit soubor package.json pomocí následujícího příkazu:

npm init

Toto spustí interaktivní nastavení. Pokud preferujete přeskočit výzvy a použít výchozí hodnoty:

npm init -y

Toto automaticky vygeneruje soubor package.json s výchozími nastaveními.

4. Běžné problémy a jak je opravit

Při používání npm na Ubuntu můžete občas narazit na chyby nebo neočekávané chování. Tato sekce pokrývá některé z nejběžnějších problémů – zejména ty, na které často narazí začátečníci – a jak je řešit.

Chyby oprávnění

Příznaky

EACCES: permission denied

Tato chyba se běžně objevuje při pokusu o globální instalaci npm.

Příčina

Tohoto se stane, když aktuální uživatel nemá práva zápisu do adresáře, kam se npm pokouší instalovat balíčky. Na Ubuntu z bezpečnostních důvodů vyžadují systémové adresáře jako /usr/lib/node_modules k úpravě sudo.

Řešení

• Spusťte instalační příkaz s sudo :

  sudo npm install -g package-name
  

• Nebo změňte globální instalační adresář na váš uživatelský adresář, aby se vyhnuli použití sudo :

  mkdir ~/.npm-global
  npm config set prefix '~/.npm-global'
  

Poté přidejte následující do vašeho ~/.bashrc nebo ~/.profile, aby se aktualizoval váš PATH:

export PATH="$HOME/.npm-global/bin:$PATH"

K aplikaci změn restartujte terminál nebo spusťte:

source ~/.bashrc

Příkaz npm Není Nalezen

Příznaky

command not found: npm

I když jste nainstalovali, terminál možná nerozpozná příkaz npm.

Příčiny

• Node.js a npm nebyly nainstalovány správně
• Umístění binárního souboru není zahrnuto v vaší PATH

Řešení

Nejprve zkontrolujte, zda je binární soubor npm dostupný:

which npm

Pokud se nic nevrátí, přeinstalujte npm nebo ověřte, zda jsou vaše proměnné prostředí nastaveny správně. Pokud používáte nvm, ujistěte se, že váš konfigurační soubor shellu (např. .bashrc nebo .zshrc) obsahuje inicializační kód nvm:

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"

Balíček se Nedaří Nainstalovat / Konflikt Verzí

Příznaky

• Instalace balíčku vede k chybám nesouladu verzí
• npm install spustí záplavu varování

Příčina

npm zobrazuje chyby nebo varování, když dochází ke konfliktům závislostí balíčků. To se často stává ve starších projektech, kde jsou stále uvedeny zastaralé balíčky.

Řešení

• Zkuste nainstalovat nejnovější verzi:

  npm install package-name@latest
  

• Zkontrolujte strom závislostí balíčku:

  npm ls package-name
  

• Vynutit instalaci (nedoporučeno, pokud to není nutné):

  npm install --legacy-peer-deps
  

• Vyčistěte svůj projekt a přeinstalujte závislosti:

  rm -rf node_modules package-lock.json
  npm install
  

Další Užitečné Tipy pro Ladění

• npm doctor : Kontroluje nastavení vašeho systému a prostředí

  npm doctor
  

• npm audit : Prohledává bezpečnostní problémy a navrhuje opravy

  npm audit
  npm audit fix
  

Většina chyb npm na Ubuntu je zobrazena v angličtině, což může na první pohled působit přehlcujícím dojmem. Ale pečlivým čtením zpráv a krok za krokem odpovídáním můžete problém obvykle rychle vyřešit.

5. Často Kladené Otázky (FAQ)

Tato sekce odpovídá na běžné otázky, které noví uživatelé Ubuntu + npm často mají. Používejte ji k prevenci problémů, než k nim dojde, a k vytvoření hladšího vývojového prostředí.

Otázka 1. Jak mohu aktualizovat npm na nejnovější verzi na Ubuntu?

Odpověď 1.

Můžete aktualizovat npm na nejnovější verzi pomocí následujícího příkazu:

sudo npm install -g npm@latest

Pokud používáte nvm, nepotřebujete sudo:

npm install -g npm@latest

K ověření nainstalované verze:

npm -v

Otázka 2. Jaký je rozdíl mezi globální a lokální instalací npm?

Odpověď 2.

• Lokální instalace:
• Používá se pro správu závislostí v rámci specifického projektu
• Balíčky jsou instalovány v adresáři node_modules
• Snadno sdílené s týmem prostřednictvím package.json
• Globální instalace:
• Používá se pro nástroje, které chcete dostupné systémově (např. CLI nástroje)
• Balíčky jsou obvykle instalovány v /usr/lib/node_modules na Ubuntu
• Pro instalaci může být vyžadováno sudo

Otázka 3. Jaké jsou výhody používání nvm?

Odpověď 3.

nvm (Node Version Manager) vám umožňuje snadno přepínat mezi více verzemi Node.js. Zde jsou výhody:

• Ideální pro správu různých verzí pro různé projekty
• Neovlivňuje systémová nastavení, což je bezpečnější
• npm je také spravováno na verzi Node, což nabízí flexibilní nastavení prostředí

Otázka 4. Co bych měl dělat, pokud se závislosti npm zkomplikují?

Odpověď 4.

Nejprve zkuste smazat node_modules a package-lock.json, poté přeinstalovat vše:

rm -rf node_modules package-lock.json
npm install

Pokud to nepomůže, zkuste použít příkaz npm ci pro čistou přeinstalaci (doporučeno pro CI/CD pipeline).

Otázka 5. Je v pořádku, když vidím „WARN“ nebo „audit“ ve výstupu npm?

Odpověď 5.

Varování (WARN) nejsou fatální, ale signalizují potenciální problémy, jako jsou zastaralé závislosti nebo zastaralé funkce.

Pro varování související s bezpečností můžete zkusit je automaticky opravit pomocí:

npm audit fix

Ideálně zkontrolujte změny a commitněte je s Git, abyste udrželi bezpečný a stabilní kódovou bázi.

Q6. Jaké typy projektů mohu vytvářet pomocí npm na Ubuntu?

A6.

npm je vaším vstupem do ekosystému JavaScriptu. Zde je jen několik věcí, které můžete na Ubuntu vytvořit:

• Frontendové aplikace používající frameworky jako React, Vue nebo Svelte
• Generátory statických stránek jako Next.js nebo Nuxt
• Backendové API pomocí Express nebo NestJS
• Vlastní nástroje CLI
• Testovací prostředí s Jest nebo Mocha

Používáním npm na Ubuntu můžete využít plnou sílu open-source ekosystému k vytváření efektivních, škálovatelných a moderních aplikací.

6. Shrnutí: Ovládání npm na Ubuntu

V tomto článku jsme pokryli vše, co potřebujete vědět k instalaci a efektivnímu používání npm na Ubuntu. Od metod instalace po základní příkazy, zde je rychlé shrnutí klíčových bodů.

Hlavní poznatky

• Co je npm? – Správce balíčků dodávaný s Node.js, výrazně zvyšuje produktivitu vývoje
• Jak nainstalovat npm na Ubuntu: – Můžete jej nainstalovat přes oficiální repozitář, NodeSource PPA nebo nvm podle vašich potřeb
• Základní funkce: – Jednoduché příkazy pro instalaci, odstraňování, aktualizaci a správu závislostí
• Řešení problémů: – Tipy pro řešení chyb oprávnění, konfliktů verzí a dalších
• Sekce FAQ: – Jasné odpovědi na časté otázky, se kterými se setkáváte při vývoji v reálném světě

Poznámka pro začátečníky

Ubuntu a npm jsou skvělou kombinací pro moderní webový vývoj. I když na začátku můžete narazit na chyby nebo zmatky, jejich řešení prohloubí vaše pochopení a pomůže vám růst jako vývojář.

Nejdůležitější je vyzkoušet si věci v praxi. Spouštění každého příkazu, čtení výstupu a učení se z chyb vám rychle vybuduje sebevědomí.

To je konec našeho průvodce používáním npm na Ubuntu. Doufáme, že vám pomůže vytvořit solidní vývojové prostředí a urychlit vaši cestu k rozvoji dovedností.

Budeme i nadále sdílet další tipy pro Linux a tutoriály pro frontend vývoj, takže si klidně přidejte tuto stránku do záložek nebo ji sdílejte na sociálních sítích!