[typescript] 명시적 타입 어노테이션을 위한 코딩 스타일 가이드

11 Dec 2023

명시적 타입 어노테이션은 TypeScript 코드를 작성할 때 매우 중요한 요소입니다. 이는 코드의 가독성을 향상시키고 타입 안정성을 보장하는 데 도움이 됩니다. 이 글에서는 명시적 타입 어노테이션을 위한 코딩 스타일 가이드를 제시하겠습니다.

1. 변수 및 상수에 타입 어노테이션 추가하기

변수나 상수를 선언할 때, 해당 값의 타입을 명시적으로 지정하는 것이 좋습니다. 이를 위해 다음과 같은 방식을 사용할 수 있습니다.

let count: number = 5;
const name: string = "John Doe";

위의 예시에서 count와 name 변수에 각각 number와 string 타입을 명시적으로 지정하였습니다.

함수의 매개변수와 반환 값에 대한 타입도 명시적으로 지정하는 것이 좋습니다. 다음은 함수 시그니처에 타입 어노테이션을 추가한 예시입니다.

function greet(name: string): void {
  console.log(`Hello, ${name}!`);
}

위의 예시에서 greet 함수의 매개변수 name과 반환 값의 타입을 각각 string과 void로 명시적으로 지정하였습니다.

인터페이스나 타입을 정의할 때도 명시적으로 타입 어노테이션을 추가하는 것이 좋습니다.

interface Person {
  name: string;
  age: number;
}

type Point = {
  x: number;
  y: number;
};

위의 예시에서 Person 인터페이스와 Point 타입에 각각 명시적으로 타입 어노테이션을 추가하였습니다.

팀 내에서 명시적 타입 어노테이션을 강조하고, 코드 리뷰 시 타입 어노테이션이 부족한 부분에 대해 피드백을 주는 것이 중요합니다.

명시적 타입 어노테이션은 TypeScript 코드를 더욱 명료하고 안정적으로 만들어줍니다. 이러한 코딩 스타일을 따르면 코드 유지 보수성을 향상시키고 버그를 줄일 수 있습니다.

참고 문헌: