스타일 가이드
이것은 Vue에 특화된 코드를 위한 공식 스타일 가이드입니다. 프로젝트에서 Vue를 사용한다면, 이 가이드는 오류, 불필요한 논쟁, 안티패턴을 피하기 위한 훌륭한 참조 자료입니다. 그러나 모든 팀이나 프로젝트에 이상적인 스타일 가이드가 있다고 생각하지는 않으므로, 과거의 경험, 주변 기술 스택, 개인적인 가치에 따라 의식적으로 변형하기를 권장합니다.
대부분의 경우, 우리는 일반적인 JavaScript 또는 HTML에 관한 제안도 피합니다. 세미콜론을 사용할지, 후행 쉼표를 사용할지는 중요하지 않습니다. HTML 속성 값에 작은따옴표를 사용할지 큰따옴표를 사용할지도 중요하지 않습니다. 그러나 Vue의 맥락에서 특정 패턴이 도움이 되는 것으로 밝혀진 몇 가지 예외가 있습니다.
마지막으로, 우리는 규칙을 네 가지 범주로 나누었습니다:
규칙 범주
우선 순위 A: 필수 (오류 방지)
이 규칙들은 오류를 방지하는 데 도움이 되므로, 반드시 숙지하고 따라야 합니다. 예외는 있을 수 있지만, 매우 드물어야 하며 JavaScript와 Vue에 대한 전문 지식을 가진 사람만이 만들어야 합니다.
우선 순위 B: 강력히 권장
이 규칙들은 대부분의 프로젝트에서 가독성 및/또는 개발자 경험을 향상시키는 것으로 밝혀졌습니다. 이 규칙들을 위반해도 코드는 여전히 실행되지만, 위반하는 경우는 드물어야 하며 정당한 이유가 있어야 합니다.
우선 순위 C: 권장
여러 가지 동등하게 좋은 옵션이 존재할 때, 일관성을 유지하기 위해 임의적인 선택을 할 수 있습니다. 이 규칙에서는 각각의 허용 가능한 옵션을 설명하고 기본 선택을 제안합니다. 즉, 일관성을 유지하고 좋은 이유가 있다면 코드베이스에서 다른 선택을 자유롭게 할 수 있습니다. 하지만 좋은 이유가 있어야 합니다! 커뮤니티 표준에 적응함으로써 다음과 같은 이점이 있습니다:
- 대부분의 커뮤니티 코드를 더 쉽게 파악할 수 있도록 두뇌를 훈련시킵니다.
- 대부분의 커뮤니티 코드 예제를 수정 없이 복사 및 붙여넣을 수 있습니다.
- 새로운 직원이 Vue에 관해 선호되는 코딩 스타일에 이미 익숙할 가능성이 높습니다.
우선 순위 D: 주의해서 사용하기
Vue의 일부 기능은 드문 에지 케이스에 대응하거나 레거시 코드베이스에서 원활하게 마이그레이션하도록 돕기 위해 존재합니다. 그러나 과도하게 사용되면 코드를 유지 관리하기 어렵게 만들거나 버그의 원인이 될 수 있습니다. 이 규칙들은 잠재적으로 위험한 기능이 무엇인지 밝히고, 언제, 왜 피해야 하는지 설명합니다.