SHIN STORYSHIN STORY
홈포스트C#TypeScriptNext.jsNode.js시리즈
</>SHIN STORY

sdf

탐색

  • 홈
  • 모든 포스트
  • 시리즈
  • 검색

카테고리

  • C#
  • TypeScript
  • Next.js
  • Node.js
  • 알고리즘
  • 개발 도구

© 2025 Shin Blog. All rights reserved.

GitHubRSS
목록으로
Node.js#JavaScript#Node.js

Node.js path 모듈 완전 정복

SHIN

2026년 4월 23일2분 읽기0
📚

Node.js 실전 팁 20선

20편
  1. 3Node.js Stream으로 대용량 파일 처리하기
  2. 4Worker Threads로 CPU 집약 작업 처리하기
  3. 5cluster 모듈로 멀티코어 CPU 100% 활용하기
  4. 6child_process로 외부 명령 실행하기
  5. 7fs/promises로 파일 시스템 다루기
  6. 20Node.js Event Loop 완전 정복
  7. Node.js path 모듈 완전 정복현재
  8. 20환경 변수 관리 — .env, dotenv, 그리고 검증
  9. 20EventEmitter 패턴으로 느슨한 결합 구현하기
  10. 20Node.js crypto 모듈로 해싱과 암호화 구현하기
  11. 20Node.js 메모리 누수 찾고 수정하기
  12. 20Express 미들웨어 패턴과 에러 처리
  13. 20Node.js CJS vs ESM 모듈 시스템 완전 정리
  14. 20Node.js Buffer와 인코딩 완전 가이드
  15. 20PM2로 Node.js 프로세스 관리하기
  16. 20Node.js HTTP 서버 직접 구현하기
  17. 20Node.js 성능 프로파일링 실전 가이드
  18. 20Node.js npm 스크립트 완전 활용하기
  19. 20Node.js 보안 체크리스트 10가지
  20. 20Node.js 테스팅 전략 — 단위, 통합, E2E 테스트

Node.js path 모듈 완전 정복

Windows와 Unix 경로 구분자가 다르기 때문에 문자열 연결 대신 path 모듈을 항상 사용해야 합니다.

핵심 메서드 요약

CODE
import path from 'path';

const filePath = '/project/src/utils/helper.ts';

path.basename(filePath)          // 'helper.ts'
path.basename(filePath, '.ts')   // 'helper'
path.extname(filePath)           // '.ts'
path.dirname(filePath)           // '/project/src/utils'
path.parse(filePath)
// { root: '/', dir: '/project/src/utils', base: 'helper.ts',
//   ext: '.ts', name: 'helper' }

path.join vs path.resolve

CODE
// join: 세그먼트를 OS 구분자로 이어붙임
path.join('/foo', 'bar', 'baz.txt')    // '/foo/bar/baz.txt'
path.join('/foo', '../bar')             // '/bar'
path.join('src', 'components', 'App')  // 'src/components/App' (상대경로)

// resolve: 절대경로를 만듦 (오른쪽에서 왼쪽으로 처리)
path.resolve('/foo', '/bar')           // '/bar'  (절대경로면 이전 것 버림)
path.resolve('/foo', 'bar')            // '/foo/bar'
path.resolve('src', 'app.js')         // CWD + '/src/app.js'

__dirname 대체 (ESM)

CODE
// CommonJS: __dirname, __filename 기본 제공
const dir = __dirname;

// ESM에서는 직접 구현
import { fileURLToPath } from 'url';
import { dirname } from 'path';

const __filename = fileURLToPath(import.meta.url);
const __dirname = dirname(__filename);

실전 패턴

CODE
import path from 'path';
import { fileURLToPath } from 'url';

const __dirname = dirname(fileURLToPath(import.meta.url));

// 프로젝트 루트 기준 경로
const ROOT = path.resolve(__dirname, '../..');
const CONFIG_PATH = path.join(ROOT, 'config', 'app.json');
const UPLOAD_DIR = path.join(ROOT, 'public', 'uploads');

// 확장자 변경
function changeExt(filePath, newExt) {
  const parsed = path.parse(filePath);
  return path.format({ ...parsed, base: '', ext: newExt });
}
changeExt('src/app.ts', '.js'); // 'src/app.js'

path.relative — 상대 경로 계산

CODE
path.relative('/data/demo', '/data/demo/file.txt')  // 'file.txt'
path.relative('/data/demo', '/data/other.txt')       // '../other.txt'

// 임포트 경로 자동 생성에 유용
function getImportPath(from, to) {
  const rel = path.relative(path.dirname(from), to);
  const noExt = rel.replace(/\.tsx?$/, '');
  return noExt.startsWith('.') ? noExt : './' + noExt;
}

path.normalize — 중복 구분자 정리

CODE
path.normalize('/foo//bar/../baz/')   // '/foo/baz'
path.normalize('C:\\Users\\..\\temp')  // 'C:\temp' (Windows)

규칙: 경로를 직접 문자열 연결(+ 또는 템플릿 리터럴)로 만들지 말고 항상 path.join 또는 path.resolve를 사용하세요.

공유
S

SHIN

.NET 개발자입니다

GitHub

이전 포스트

fs/promises로 파일 시스템 다루기

다음 포스트

환경 변수 관리 — .env, dotenv, 그리고 검증

환경 변수 관리 — .env, dotenv, 그리고 검증

같은 카테고리 포스트

Node.js 테스팅 전략 — 단위, 통합, E2E 테스트

Node.js 테스팅 전략 — 단위, 통합, E2E 테스트

2026년 5월 6일· 2분
Node.js 보안 체크리스트 10가지

Node.js 보안 체크리스트 10가지

2026년 5월 5일· 2분
Node.js npm 스크립트 완전 활용하기

Node.js npm 스크립트 완전 활용하기

2026년 5월 4일· 1분

댓글