Ch 05. 실습 코드 저장소

저장소 위치

모든 실습 코드는 아래 GitHub 저장소에 있습니다.

https://github.com/ibetterkr/textbook-typescript-practical

브랜치 구조

각 PART의 시작 상태와 완성 상태를 별도 브랜치로 관리합니다.

main                  ← 최신 완성본
part-01-start         ← PART 01 시작 전 상태
part-01-done          ← PART 01 완성 상태
part-02-start         ← PART 02 시작 전 상태
part-02-done          ← PART 02 완성 상태
...

-start 브랜치는 해당 PART를 직접 따라 작성하기 위한 출발점입니다. -done 브랜치는 PART를 완료한 참고용 코드입니다.

저장소 클론과 첫 실행

# 저장소 클론git clone https://github.com/ibetterkr/textbook-typescript-practical.gitcd textbook-typescript-practical# 의존성 설치npm install# PART 01 실습 시작 브랜치로 전환git checkout part-01-start# TypeScript 컴파일 확인npx tsc --version

디렉토리 구조

저장소의 전체 구조는 다음과 같습니다.

textbook-typescript-practical/
├── part-01/                  ← PART 01 실습 코드
│   ├── hello-ts/
│   └── tsconfig-demo/
├── part-02/                  ← PART 02 실습 코드
│   └── type-system/
├── part-03/
├── part-04/
├── part-05/
├── part-06/
├── part-07/                  ← React Todo 앱 (PART 07)
│   └── todo-app/
├── part-08/                  ← REST API 서버 (PART 08)
│   └── api-server/
├── part-09/
└── part-10/

각 PART 폴더에는 해당 챕터에서 만드는 프로젝트 코드가 있습니다.

코드 실행 요구사항

PART 07 (React 앱)은 추가로 다음이 필요합니다.

버전 불일치 해결

코드 실행 중 버전 관련 오류가 발생하면 다음을 확인합니다.

# Node.js 버전 확인node --version# npm 버전 확인npm --version# 프로젝트 TypeScript 버전 확인npx tsc --version# TypeScript 최신 버전으로 업데이트npm install typescript@latest --save-dev

Node.js 버전 관리가 필요하다면 nvm(macOS/Linux) 또는 nvm-windows(Windows)를 사용합니다.

# nvm으로 Node.js 22 설치nvm install 22nvm use 22

오탈자 및 오류 신고

책 내용의 오류나 코드 버그는 GitHub Issues에 등록해주세요.

https://github.com/ibetterkr/textbook-typescript-practical/issues

이슈 등록 시 다음 정보를 포함하면 빠르게 처리됩니다.

• 오류가 발생한 PART와 챕터
• 실행 환경 (OS, Node.js 버전, TypeScript 버전)
• 오류 메시지 전체
• 재현 코드 (가능하다면)

다음 챕터에서는 업데이트 현황을 확인합니다.