Jak používat npm v Ubuntu: instalace, základní příkazy a průvodce řešením problémů

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). npm je široce používán jako nástroj pro správu balíčků pro Node.js, který vývojářům umožňuje snadno instalovat a spravovat JavaScriptové knihovny a nástroje.

Používáním npm na Ubuntu můžete využít lehké výkonnosti Linuxu a flexibilní správu balíčků, přičemž výrazně zvyšujete efektivitu vývoje. Ubuntu je distribuce podporovaná velkou komunitou vývojářů a je široce používána pro vše od serverových operací po lokální vývojová prostředí.

Obzvláště při práci s frameworky založenými na Node.js, jako jsou Vue.js, React a Next.js, je správa balíčků pomocí npm standardním přístupem. Nastavením těchto nástrojů na Ubuntu si vytvoříte stabilní vývojové prostředí s méně problémy než na Windows nebo macOS.

Účel tohoto článku

Tento článek poskytuje krok‑za‑krokem návod na instalaci npm na Ubuntu a osvojení si jeho základního používání. Je určen zejména pro následující publikum:

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

Představíme několik metod instalace, včetně jejich vlastností, výhod a nevýhod. Navíc tento průvodce pokrývá běžné chyby, tipy na odstraňování problémů a užitečné příkazy, které čtenářům pomohou plynule používat npm na Ubuntu.

2. Instalace Node.js a npm na Ubuntu

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

Níže jsou tři hlavní metody instalace Node.js a npm na Ubuntu. Každá metoda má své specifické charakteristiky, takže je důležité vybrat tu, která nejlépe odpovídá vašemu stylu vývoje a účelu.

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

Kroky

Node.js je dostupný v standardních repozitářích Ubuntu. Jedná se o nejjednodušší a nejvíce přívětivý přístup pro začátečníky.

sudo apt update
sudo apt install nodejs npm

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

node -v
npm -v

Výhody

• Jednoduché příkazy, které jsou snadno pochopitelné
• Stabilní verze poskytované Ubuntu

Nevýhody

• Verze Node.js a npm jsou často zastaralé, takže nejnovější funkce nemusí být k dispozici

Metoda 2: Použití NodeSource PPA

Použitím repozitáře NodeSource, který úzce sleduje oficiální podporu Node.js, můžete nainstalovat novější verze Node.js a npm.

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 se automaticky nainstaluje spolu s Node.js.

Výhody

• Přístup k relativně novým a stabilním verzím
• Snadná instalace s dobrou kompatibilitou s Ubuntu

Nevýhody

• Stejně jako u jiných PPA může být potřeba spravovat 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 nejvýkonnější volbou.

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 se automaticky nainstaluje spolu s Node.js.

Výhody

• Volný přepínání mezi verzemi Node.js
• Nastavení vhodných verzí pro každý projekt
• Bezpečné, protože neovlivňuje systém globálně

Nevýhody

• Mírně složitější nastavení ve srovnání s ostatními metodami
• Vyžaduje úpravu konfiguračních souborů shellu

Kterou metodu si vybrat?

Obecně je nvm nejdoporučovanější volbou pro dlouhodobý vývoj npm na Ubuntu. Pokud však chcete rychlé a jednoduché nastavení, použití NodeSource PPA je také solidní volba.

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

Jakmile jsou na Ubuntu nainstalovány Node.js a npm, můžete začít spravovat balíčky pomocí npm. npm je výkonný nástroj pro instalaci, aktualizaci a odstraňování JavaScriptových balíčků.

Tato sekce představuje často používané příkazy npm a základní operace.

Instalace balíčků

Lokální instalace

Balíčky používané pouze v rámci konkrétního projektu by měly být instalovány lokálně. To je standardní přístup. Balíčky jsou instalovány do adresáře node_modules a zaznamenány v package.json.

npm install package-name

Příklad: Instalace axios

npm install axios

Pouze skripty v rámci stejného projektu mohou používat lokálně nainstalované balíčky.

Globální instalace

Nástroje používané v celém systému, jako jsou CLI utility, by měly být instalovány globálně.

npm install -g package-name

Příklad: Instalace http-server globálně

sudo npm install -g http-server

Na Ubuntu může použití -g vyžadovat sudo.

Odinstalace balíčků

Odstranění lokálních balíčků

npm uninstall package-name

Odstranění globálních balíčků

sudo npm uninstall -g package-name

Aktualizace balíčků

Aktualizace konkrétního balíčku

npm update package-name

Aktualizace všech závislostí

npm update

Aktualizace jsou aplikovány v rámci verzových rozsahů specifikovaných v package.json, takže věnujte pozornost verzovým omezením.

Instalace vývojových závislostí (–save-dev)

Balíčky určené pouze pro vývoj, jako jsou testovací nebo build nástroje, by měly být instalovány pomocí volby --save-dev.

npm install --save-dev package-name

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

npm install --save-dev jest

Tím se balíček zaznamená pod devDependencies v package.json.

Výpis nainstalovaných balíčků

Výpis lokálních balíčků

npm list

Výpis globálních balíčků

npm list -g --depth=0

Použití --depth=0 zobrazuje pouze balíčky nejvyšší úrovně, což usnadňuje čtení výstupu.

Správa závislostí pomocí package.json

package.json je základní součástí projektů založených na npm. Zaznamenává názvy balíčků, verze, skripty a celkovou konfiguraci projektu.

Můžete jej vytvořit pomocí:

npm init

Pro zjednodušené nastavení s výchozími hodnotami:

npm init -y

4. Časté problémy a řešení

Při používání npm na Ubuntu můžete narazit na chyby nebo neočekávané chování. Tato sekce představuje běžné problémy a jak je řešit.

Chyby oprávnění

Příznak

EACCES: permission denied

Příčina

K tomu dochází, když aktuální uživatel nemá oprávnění k zápisu do adresáře, kam se npm snaží instalovat balíčky. Na Ubuntu zápis do systémových adresářů, jako je /usr/lib/node_modules, vyžaduje sudo.

Řešení

• Spusťte s sudo :

  sudo npm install -g package-name
  

• Nebo změňte globální instalační adresář na cestu vlastněnou uživatelem:

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

Přidejte následující do ~/.bashrc nebo ~/.profile:

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

Aplikujte změny:

source ~/.bashrc

Příkaz npm nenalezen

Příznak

command not found: npm

Příčina

• Instalace Node.js nebo npm selhala
• Není nastavená proměnná prostředí PATH

Řešení

Zkontrolujte cestu:

which npm

Pokud se nic nevrátí, přeinstalujte nebo ověřte nastavení PATH. Pokud používáte nvm, ujistěte se, že inicializační kód existuje ve vašem konfiguračním souboru shellu:

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

Selhání instalace balíčků nebo konflikty verzí

Příznaky

.* Konflikty verzí při instalaci balíčku * Početná varování během npm install

Řešení

npm install package-name@latest

npm ls package-name

npm install --legacy-peer-deps

rm -rf node_modules package-lock.json
npm install

Užitečné příkazy pro ladění

• npm doctor

  npm doctor
  

• npm audit

  npm audit
  npm audit fix
  

5. Často kladené otázky (FAQ)

Q1. Jak mohu aktualizovat npm na nejnovější verzi na Ubuntu?

Odpověď 1.

sudo npm install -g npm@latest

Pokud používáte nvm, sudo není vyžadováno.

Q2. Jaký je rozdíl mezi globální a lokální instalací?

Odpověď 2.

• Lokální instalace : Závislosti specifické pro projekt uložené v node_modules
• Globální instalace : Nástroje CLI dostupné v celém systému, často vyžadující sudo

Q3. Jaké jsou výhody používání nvm?

Odpověď 3.

nvm vám umožňuje bezpečně a efektivně přepínat mezi více verzemi Node.js, což je ideální pro vývoj více projektů.

Q4. Co mám dělat, když se npm závislosti porouchají?

Odpověď 4.

rm -rf node_modules package-lock.json
npm install

Q5. Jsou npm WARN a audit zprávy problém?

Odpověď 5.

Varování nejsou fatální, ale naznačují potenciální problémy. Pro varování související s bezpečností můžete zkusit:

npm audit fix

Q6. Co mohu stavět s npm na Ubuntu?

Odpověď 6.

• Frontendové frameworky (React, Vue, Svelte)
• Generátory statických stránek (Next.js, Nuxt)
• Backendové aplikace (Express, NestJS)
• CLI nástroje
• Testovací prostředí

6. Závěr: Ovládněte npm na Ubuntu

Tento článek pokrývá základy instalace a používání npm na Ubuntu, od nastavení po řešení problémů.

Nejdůležitějším krokem je praktické experimentování. Spouštěním příkazů a porozuměním chybovým zprávám postupně prohloubíte své dovednosti jako vývojář.

Tímto končí kompletní průvodce používáním npm na Ubuntu. Doufáme, že vám pomůže vytvořit efektivnější a výkonnější vývojové prostředí.