You signed in with another tab or window.Reload to refresh your session.You signed out in another tab or window.Reload to refresh your session.You switched accounts on another tab or window.Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: 1-js/03-code-quality/02-coding-style/article.md
+9-9Lines changed: 9 additions & 9 deletions
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
3
3
개발자는 가능한 한 간결하고 읽기 쉽게 코드를 작성해야 합니다.
4
4
5
-
복잡한 문제를 간결하고 사람이 읽기 쉬운코드를 작성해 해결하는 것이야말로 진정한 프로그래밍 기술입니다. 좋은 코드 스타일은 이런 기술을 연마하는 데 큰 도움을 줍니다.
5
+
복잡한 문제를 간결하고 사람이 읽기 쉬운코드로 작성해 해결하는 것이야말로 진정한 프로그래밍 기술입니다. 좋은 코드 스타일은 이런 기술을 연마하는 데 큰 도움을 줍니다.
6
6
7
7
##문법
8
8
@@ -52,7 +52,7 @@ if (condition) {
52
52
}
53
53
```
54
54
55
-
`if (condition) doSomething()`같은 단 한 줄짜리 구문은 중요하게 다뤄야 할 에지 케이스입니다. 이런 예외상황에도 중괄호를 써야 할까요?
55
+
`if (condition) doSomething()`과같은 단 한 줄짜리 구문은 중요하게 다뤄야 할 에지 케이스입니다. 이런 예외상황에도 중괄호를 써야 할까요?
56
56
57
57
어떻게 코드를 작성해야 가독성이 좋을지 직접 판단해 보시라고 주석과 함께 몇 가지 예시를 만들어보았습니다.
58
58
@@ -80,7 +80,7 @@ if (condition) {
80
80
81
81
### 가로 길이
82
82
83
-
가로로 길게 늘어진 코드를읽는걸 좋아하는 개발자는 없습니다. 코드의 가로 길이가 길어진다면 여러 줄로 나눠 작성하는 게 좋습니다.
83
+
가로로 길게 늘어진 코드를읽는 걸 좋아하는 개발자는 없습니다. 코드의 가로 길이가 길어진다면 여러 줄로 나눠 작성하는 게 좋습니다.
84
84
85
85
예시:
86
86
```js
@@ -104,13 +104,13 @@ if (
104
104
}
105
105
```
106
106
107
-
최대 가로 길이는 팀원들과 합의해 정하는게 좋습니다.대게 80자나 120자로제한하는게 일반적입니다.
107
+
최대 가로 길이는 팀원들과 합의해 정하는게 좋습니다.대개 80자나 120자로제한하는 게 일반적입니다.
108
108
109
109
### 들여쓰기
110
110
111
111
들여쓰기에는 두 종류가 있습니다.
112
112
113
-
- **가로 들여쓰기: 스페이스 두 개 혹은 네 개를 사용해만듬**
113
+
- **가로 들여쓰기: 스페이스 두 개 혹은 네 개를 사용해만듦**
114
114
115
115
가로 들여쓰기는 스페이스 두 개 혹은 네 개를 사용하거나 탭 키(`key:Tab`)를 이용해 만들 수 있습니다. 어떤 방법을 쓸지에 대한 논쟁은 오래전부터 있었는데, 요즘엔 탭 대신 스페이스를 이용하는 게 더 우위에 있는 것 같습니다.
116
116
@@ -151,7 +151,7 @@ if (
151
151
152
152
자바스크립트 엔진에 의해 무시되더라도 모든 구문의 끝엔 세미콜론을 써주는 것이 좋습니다.
153
153
154
-
구문 끝에 세미콜론을 적는 게 완전히 선택사항인 언어가 몇몇 있는데 이런 언어들에선 세미콜론을 잘 쓰지 않습니다. 그러나 자바스크립트에선 줄 바꿈이세미 콜론으로해석되지 않는 몇몇 상황이 있기 때문에 세미콜론을 생략하고 코딩하는 습관을 들이면 에러를 발생시키는 코드를 만들 수 있습니다. 자세한 사례는 <info:structure#semicolon>챕터에서 살펴보세요.
154
+
구문 끝에 세미콜론을 적는 게 완전히 선택사항인 언어가 몇몇 있는데 이런 언어들에선 세미콜론을 잘 쓰지 않습니다. 그러나 자바스크립트에선 줄 바꿈이세미콜론으로해석되지 않는 몇몇 상황이 있기 때문에 세미콜론을 생략하고 코딩하는 습관을 들이면 에러를 발생시키는 코드를 만들 수 있습니다. 자세한 사례는 <info:structure#semicolon>챕터에서 살펴보세요.
155
155
156
156
경험이 많은 자바스크립트 개발자라면 [StandardJS](https://standardjs.com/)에서 제시하는 스타일 가이드처럼 세미콜론 없이 코드를 작성할 수도 있습니다. 초보 개발자라면 에러를 만들 확률을 줄이기 위해서라도 세미콜론을 사용하는 게 좋습니다.
157
157
@@ -271,15 +271,15 @@ function pow(x, n) {
271
271
```
272
272
3. 혼합: 코드 바로 위에서 필요한 헬퍼 함수 그때그때 선언하기
273
273
274
-
대게는 두 번째 방법으로 코드를 정돈하는 걸 선호합니다.
274
+
대개는 두 번째 방법으로 코드를 정돈하는 걸 선호합니다.
275
275
276
276
사람들은 코드를 이 코드가 '무엇을 하는지'를 생각하며 코드를 읽기 때문에 코드가 먼저 나오는 것이 자연스럽기 때문입니다. 이름만 보고도 헬퍼 함수의 역할을 쉽게 유추할 수 있게 헬퍼 함수 이름을 명명했다면 함수 본문을 읽을 필요도 없습니다.
277
277
278
278
## 스타일 가이드
279
279
280
280
코딩 스타일 가이드는 코드를 '어떻게 작성할지'에 대한 전반적인 규칙을 담은 문서로, 어떤 따옴표를 쓸지, 들여쓰기할 때 스페이스를 몇 개 사용할지, 최대 가로 길이는 몇까지 제한할지 등의 내용이 담겨있습니다.
281
281
282
-
팀원 전체가동일 스타일 가이드를 따라 코드를 작성하면, 누가 코드를 작성했나에 관계없이 동일한 스타일의 코드를 만들 수 있습니다.
282
+
팀원 전체가동일한 스타일 가이드를 따라 코드를 작성하면, 누가 코드를 작성했나에 관계없이 동일한 스타일의 코드를 만들 수 있습니다.
283
283
284
284
팀원들이 모여 팀 전용 스타일 가이드를 만들 수도 있는데, 요즘엔 이미 작성된 가이드 중 하나를 선택해 팀의 가이드로 삼는 편입니다.
285
285
@@ -291,7 +291,7 @@ function pow(x, n) {
291
291
- [StandardJS](https://standardjs.com/)
292
292
- 기타 등등
293
293
294
-
초보 개발자라면 상단 치트 시트를 시작으로 본인만의 스타일을 가이드를 만들어 보시기 바랍니다. 유명 스타일 가이드 등을 살펴보며 아이디어를 얻고,맘에 드는 규칙은 본인의 스타일 가이드에 반영해 보시기 바랍니다.
294
+
초보 개발자라면 상단 치트 시트를 시작으로 본인만의 스타일을 가이드를 만들어 보시기 바랍니다. 유명 스타일 가이드 등을 살펴보며 아이디어를 얻고,마음에 드는 규칙은 본인의 스타일 가이드에 반영해 보시기 바랍니다.