Dlaczego używać modułu path zamiast konkatenacji stringów?

Question

Accepted Answer

Wbudowany moduł **`path`** buduje i manipuluje ścieżkami plików **poprawnie na wszystkich systemach operacyjnych**. Ręczne konkatenowanie ścieżek za pomocą `/` nie działa na Windows (który używa `\`) i źle obsługuje przypadki brzegowe — `path` obsługuje wszystko niezawodnie.

## Problem z konkatenacją stringów

```js
// ❌ fragile, OS-dependent, error-prone
const filePath = baseDir + "/" + "sub" + "/" + fileName;
// breaks on Windows (\), doubles slashes if baseDir ends in /, etc.
```

## Rozwiązanie: path.join

```js
import path from "path";

// ✅ uses the correct separator for the OS, normalizes slashes
const filePath = path.join(baseDir, "sub", fileName);
// Linux/Mac: baseDir/sub/file.txt   Windows: baseDir\sub\file.txt
```

`path.join` wstawia właściwy separator, redukuje duplikaty/końcowe ukośniki i rozwiązuje segmenty `..`/`.`.

## Inne ważne funkcje path

```js
path.resolve("src", "app.js");  // → ABSOLUTE path from the cwd
path.basename("/a/b/file.txt");  // "file.txt"
path.dirname("/a/b/file.txt");   // "/a/b"
path.extname("file.txt");        // ".txt"
path.parse("/a/b/file.txt");     // { dir, base, name, ext }
path.sep;                         // "/" or "\" depending on OS
```

## Uzyskiwanie katalogu bieżącego pliku

```js
// CommonJS — built-in globals
const configPath = path.join(__dirname, "config.json");

// ES Modules — __dirname doesn't exist; derive it from import.meta.url
import { fileURLToPath } from "url";
const __dirname = path.dirname(fileURLToPath(import.meta.url));
```

Budowanie ścieżek względnych do bieżącego pliku (z `__dirname` lub jego odpowiednikiem ESM) to bezpieczny sposób na odwołanie się do plików — niezależnie od tego, gdzie został uruchomiony proces.

## join vs resolve

```text
path.join    → just joins segments (relative stays relative)
path.resolve → produces an ABSOLUTE path (resolves from cwd / right-to-left)
```

## Dlaczego to ważne

Używanie `path` zamiast konkatenacji stringów sprawia, że kod obsługujący pliki jest **wieloplatformowy i niezawodny** — częste źródło błędów, gdy kod napisany na Mac/Linux nie działa na Windows lub gdy konkatenacja tworzy niepoprawne ścieżki.

To mały nawyk z dużymi korzyściami dotyczącymi niezawodności, a znajomość `join` vs `resolve` plus wiedza o tym, jak uzyskać `__dirname` w ESM, pokrywa codzienne potrzeby dotyczące ścieżek w każdym projekcie Node.js, który pracuje z systemem plików.