타입스크립트에서 타입스크립트의 코드 리팩토링 방법은 무엇인가요?

Q1. 리팩토링이란 무엇인가요?
A1. 리팩토링은 외부 동작(Behavior)을 변경하지 않으면서 내부 구조를 개선하는 작업입니다. 코드 가독성과 유지보수성을 높이고 버그 발생 가능성을 줄이는 것이 목적입니다.

Q2. TypeScript 리팩토링을 시작하기 전 체크리스트는 무엇인가요?
A2.
- tsconfig.json 설정(“strict”, “noImplicitAny”, “strictNullChecks” 등) 확인
- 코드베이스 테스트 커버리지 확보(단위·통합 테스트)
- 린팅/포매팅 도구(ESLint, Prettier) 설정
- 코드 리뷰 프로세스 및 브랜치 전략 정립

Q3. any 타입을 제거하는 방법은?
A3.
1. noImplicitAny 옵션 활성화 후 컴파일 오류 확인
2. any → unknown으로 변경하고 필요한 부분에서 타입 좁히기(type narrowing)
3. 구체적 인터페이스나 유틸리티 타입(Partial, Record 등)으로 대체
4. 대규모 변경 시 ts-morph나 codemod 스크립트 활용

Q4. 인터페이스(interface)와 타입 별칭(type alias) 중 언제 사용해야 하나요?
A4.
- interface
• 상속(extends)을 통한 확장에 최적화
• 선언 병합(declaration merging) 지원
- type alias
• 유니온/튜플/매핑된 타입 등 복잡한 타입 표현이 필요할 때
• 기본 타입이나 제네릭 유틸리티 타입 조합 시 사용
⇒ 둘 다 사용 가능하나 확장성이 중요한 경우 interface를, 복잡 구문 조합엔 type alias를 권장

Q5. 제네릭(Generic)으로 중복 코드를 줄이는 방법은?
A5.
1. 공통 로직의 입력·출력 타입을 제네릭으로 추상화
2. 타입 제약(extends)을 통해 타입 안전성 보장
3. 함수·클래스·인터페이스에 제네릭 적용
예)
```ts
function wrap(value: T): { value: T } {
return { value };
}
```

Q6. 유틸리티 타입으로 리팩토링하는 팁은?
A6.
- Partial, Required, Readonly로 선택적/필수·읽기전용 속성 정의
- Pick·Omit로 특정 속성만 추출·제외
- Record로 키-값 맵 타입 생성
- Exclude/Extract로 유니온 타입 조작

Q7. 코드 구조(파일·디렉토리) 리팩토링 방법은?

A7.
- 기능 단위(Feature-Based) 폴더 구조 채택
- index.ts로 공개 API만 노출(명시적 경로 사용 최소화)
- 레이어 분리(API, service, domain, utils 등)
- 모노레포(Lerna, Nx) 또는 멀티 패키지 설정 고려

Q8. 함수형 스타일로 리팩토링하려면?
A8.
- 순수 함수(Pure Function) 우선 작성
- 불변성 유지(Immutability) – Object.freeze, spread 연산자 사용
- 고차 함수(Higher-Order Function)·커링(Currying) 활용
- 라이브러리(Ramda, Lodash/fp) 도입 검토

Q9. 클래스 기반 코드를 함수·인터페이스 기반으로 바꾸는 방법은?
A9.
1. 메서드를 순수 함수로 추출
2. 상태를 인자로 전달하거나 불변 객체로 관리
3. 인터페이스로 타입 정의 및 의존성 주입(DI)
4. 필요시 Factory 함수로 객체 생성

Q10. 레거시 JavaScript를 TypeScript로 전환할 때 주의할 점은?
A10.
- 단계별 마이그레이션(enable JS + allowJs)
- @ts-ignore 남발 지양, 구체적 타입 선언 우선
- any → unknown → 구체적 타입 순차 적용
- 코드 모듈별로 점진적 strict 모드 활성화

Q11. VSCode·IDE 자동 리팩토링 기능 활용법은?
A11.
- Rename Symbol(Ctrl+F2), Extract Function/Constant
- 인라인(In-line) 및 추출 리팩토링 단축키
- Quick Fix(Alt+Enter)로 타입 제안·자동 import
- ts-morph 기반 스크립트로 대규모 코드 변경 자동화

Q12. 리팩토링 후 검증·배포 파이프라인 구성은?
A12.
- Git Hook(Husky)으로 커밋 전 lint·test 실행
- CI(CircleCI, GitHub Actions)에서 빌드·테스트·릴리즈
- 코드 커버리지 도구(Istanbul, Coveralls)로 리포트
- 배포 전 타입 체크(tsc --noEmit) 및 동적 테스트

Q13. 지속적인 리팩토링을 위한 베스트 프랙티스는?
A13.
- 테스트 주도 개발(TDD)로 리팩토링 안전망 확보
- 코드 리뷰 가이드라인에 리팩토링 룰 포함
- 정기적인 코드 스멜(Code Smell) 점검
- 소규모 변경·커밋 단위로 자주 리팩토링
- 도구(ESLint Rule, SonarQube)로 자동화된 품질 관리

타입스크립트에서 타입을 변환하는 방법은 무엇인가요?

타입스크립트에서 타입을 변환하는 유틸리티 타입은 무엇이 있나요?

타입스크립트(TypeScript)는 자바스크립트의 상위 집합으로, 정적 타입 검사 기능을 제공하여 코드의 품질과 유지 보수성을 높이는 데 도움을 줍니다.

코드 리팩토링은 기존의 코드를 개선하여 가독성과 효율성을 높이는 과정으로, 타입스크립트에서도 여러 가지 방법으로 리팩토링을 진행할 수 있습니다.

아래에서는 타입스크립트에서 코드 리팩토링을 수행하는 다양한 방법을 설명하겠습니다.

1. 타입 정의 개선 타입스크립트의 가장 큰 장점 중 하나는 강력한 타입 시스템입니다.

리팩토링 시, 타입 정의를 개선하여 코드의 가독성을 높일 수 있습니다.

- 인터페이스와 타입 별칭 사용 : 복잡한 객체 구조를 다룰 때는 인터페이스나 타입 별칭을 사용하여 코드의 가독성을 높이고 재사용성을 증가시킬 수 있습니다.

```typescript interface User { id: number; name: string; email: string; } function getUserInfo(user: User): string { return `${user.name} (${user.email})`; } ``` - 제네릭 사용 : 다양한 타입에 대해 동일한 로직을 적용할 수 있도록 제네릭을 활용하면 코드의 중복을 줄일 수 있습니다.

```typescript function identity(arg: T): T { return arg; } ```

2. 함수와 메서드 리팩토링 함수와 메서드를 리팩토링하여 코드의 재사용성과 가독성을 높일 수 있습니다.

- 작고 단순한 함수로 분리 : 하나의 함수가 너무 많은 일을 할 경우, 이를 여러 개의 작은 함수로 나누어 각 함수가 한 가지 일만 하도록 합니다.

```typescript function processUser(user: User) { const userInfo = getUserInfo(user); sendEmail(user.email, userInfo); } ``` - 고차 함수 활용 : 공통된 로직을 고차 함수로 추출하여 코드 중복을 줄입니다.

```typescript function withLogging(fn: Function) { return function(...args: any[]) { console.log(`Calling function with args: ${args}`); return fn(...args); }; } const loggedGetUserInfo = withLogging(getUserInfo); ```

3. 모듈화 코드를 모듈화하여 관리하기 쉽게 만듭니다.

- 모듈과 네임스페이스 사용 : 관련된 기능을 모듈로 묶어 코드의 구조를 명확하게 하고, 네임스페이스를 사용하여 이름 충돌을 방지합니다.

```typescript export namespace UserModule { export interface User { id: number; name: string; } export function getUser(id: number): User { // ... } } ```

4. 타입 추론과 타입 안전성 타입스크립트의 타입 추론 기능을 활용하여 코드의 타입 안전성을 높입니다.

- 명시적 타입 선언 최소화 : 타입스크립트는 많은 경우 타입을 자동으로 추론할 수 있습니다.

불필요하게 타입을 명시적으로 선언하는 것을 피하고, 코드의 간결성을 유지합니다.

```typescript const user = { id: 1, name: 'Alice' }; // 타입 추론 ```

5. ESLint와 Prettier 사용 코드 품질을 유지하기 위해 ESLint와 Prettier와 같은 도구를 사용하여 코드 스타일을 일관되게 유지합니다.

- ESLint 설정 : 타입스크립트에 맞는 ESLint 규칙을 설정하여 코드 품질을 높이고, 잠재적인 오류를 사전에 방지합니다.

- Prettier 설정 : 코드 포맷팅 도구인 Prettier를 사용하여 코드 스타일을 일관되게 유지합니다.



6. 테스트와 문서화 리팩토링 후에는 코드의 동작을 보장하기 위해 테스트를 추가하고, 코드의 의도를 명확히 하기 위해 문서화를 진행합니다.

- 유닛 테스트 작성 : 리팩토링한 코드에 대해 유닛 테스트를 작성하여 기능이 정상적으로 작동하는지 확인합니다.

- 주석과 문서화 : 코드의 복잡한 부분이나 중요한 로직에 대해 주석을 추가하고, 필요한 경우 문서화하여 팀원들이 이해할 수 있도록 합니다.

결론 타입스크립트에서의 코드 리팩토링은 코드의 가독성과 유지 보수성을 높이는 중요한 과정입니다.

타입 정의 개선, 함수 리팩토링, 모듈화, 타입 안전성 강화, 코드 품질 도구 사용, 테스트 및 문서화 등을 통해 효과적으로 리팩토링을 진행할 수 있습니다.

이러한 방법들을 통해 코드의 품질을 지속적으로 개선하고, 팀원 간의 협업을 원활하게 할 수 있습니다.