109 lines
7.5 KiB
Markdown
109 lines
7.5 KiB
Markdown
|
---
|
|||
|
title: Clean Code Guidelines
|
|||
|
localeTitle: Рекомендации по чистому коду
|
|||
|
---
|
|||
|
# Рекомендации по чистому коду
|
|||
|
|
|||
|
При кодировании стиль кодирования, который вы следуете, может быть очень важным. Специально, когда вы работаете с командой или планируете поделиться своим код. Большинство из этих рекомендаций являются стандартными и могут применяться к большинству языков программирования, однако здесь у вас есть приложения и фрагменты с кодом на C ++, поэтому вы можете легко ознакомиться с ним. Помните, что это только рекомендации для достижения ясности, которые могут быть личным преференцией, поэтому возьмите эти советы а не принимать их к письму. Иногда нарушение некоторых из этих правил может привести к созданию более чистого кода.
|
|||
|
|
|||
|
## Использовать хорошие имена переменных и делать комментарии
|
|||
|
|
|||
|
Убедитесь, что вы создаете хорошие имена переменных, например, если вы создаете игру, избегайте использования переменной «a», используйте что-то вроде «p1», ссылаясь на игрока 1. [Венгерская нотация](https://en.wikipedia.org/wiki/Hungarian_notation) обычно распространяется и может дать вам некоторые путевые точки для объявления переменные.
|
|||
|
|
|||
|
Кроме того, ПОЖАЛУЙСТА, используйте комментарии, я даже не шучу, просто попробуйте прочитать некоторые старые проекты, которые вы сделали без комментариев ... теперь представьте, что вы кто-то другой, который даже не закодировал его.
|
|||
|
|
|||
|
## Глобальные переменные
|
|||
|
|
|||
|
Глобальные переменные могут быть просты в использовании, и с небольшим кодом он может выглядеть как отличное решение. Но, когда код становится все больше и больше, становится все труднее узнать, когда они используются.
|
|||
|
|
|||
|
Вместо использования глобальных переменных вы можете использовать переменные, объявленные в функциях, которые могут помочь вам рассказать, какие значения передаются и быстрее выявлять ошибки.
|
|||
|
|
|||
|
```cpp
|
|||
|
#include <iostream>
|
|||
|
using namespace std;
|
|||
|
|
|||
|
// Global variables are declared outside functions
|
|||
|
int cucumber; // global variable "cucumber"
|
|||
|
```
|
|||
|
|
|||
|
## Использование goto, продолжить и т. Д.
|
|||
|
|
|||
|
Это обычное обсуждение среди программистов, как и глобальные переменные, эти типы утверждений обычно считаются плохими. Они считаются плохими, потому что они приводят к [«коду spaguetti»](https://en.wikipedia.org/wiki/Spaghetti_code) . Когда мы программируем, мы хотим линейный поток, при использовании этих утверждений поток изменяется и приводит к «скрученному и запутанному» потоку.
|
|||
|
|
|||
|
Goto использовался в прошлом, когда, хотя, если функции, однако, были введены в действие для такого структурированного программирования. В общем, избегайте использования goto, если вы не уверены, что сделает ваш код более чистым и более легким для чтения. В качестве примера можно использовать его в вложенных циклах.
|
|||
|
|
|||
|
Использование разрыва и продолжения практически одинаково. Используйте их в переключателях и пытайтесь выполнять функции с единственной целью, поэтому у вас есть только одна точка выхода.
|
|||
|
|
|||
|
![IMG](https://imgs.xkcd.com/comics/goto.png)
|
|||
|
|
|||
|
## Избегайте изменения управляющей переменной внутри цикла for
|
|||
|
|
|||
|
Обычно есть работы вокруг этого, которые выглядят яснее и менее запутанными, например. в то время как циклы. Делать:
|
|||
|
|
|||
|
```cpp
|
|||
|
int i=1;
|
|||
|
while (i <= 5)
|
|||
|
{
|
|||
|
if (i == 2)
|
|||
|
i = 4;
|
|||
|
|
|||
|
++i;
|
|||
|
}
|
|||
|
```
|
|||
|
|
|||
|
Вместо:
|
|||
|
|
|||
|
```cpp
|
|||
|
for (int i = 1; i <= 5; i++)
|
|||
|
{
|
|||
|
if (i == 2)
|
|||
|
{
|
|||
|
i = 4;
|
|||
|
}
|
|||
|
// Do work
|
|||
|
}
|
|||
|
```
|
|||
|
|
|||
|
## Объявлять константы и типы вверху
|
|||
|
|
|||
|
Они обычно объявляются после библиотек, что делает их доступными и более удобными для чтения. Для локальных переменных это происходит одинаково, объявляйте их наверху (другие люди предпочитают объявлять их как можно более поздними, чтобы сохранить память: [cplusplus.com](http://www.cplusplus.com/forum/general/33612/)
|
|||
|
|
|||
|
## Используйте только одну функцию возврата в конце
|
|||
|
|
|||
|
Как мы уже говорили, мы делаем только одну запись и выход, чтобы сделать поток более четким.
|
|||
|
|
|||
|
## Используйте фигурные скобки, даже при написании однострочных
|
|||
|
|
|||
|
Систематически это поможет вам сделать это быстрее, и если вы захотите изменить код в будущем, вы сможете сделать это без забот.
|
|||
|
|
|||
|
Вместо:
|
|||
|
|
|||
|
```cpp
|
|||
|
for (int i = 1; i <= 5; i++)
|
|||
|
//CODE
|
|||
|
```
|
|||
|
|
|||
|
Делать:
|
|||
|
|
|||
|
```cpp
|
|||
|
for (int i = 1; i <= 5; i++)
|
|||
|
{
|
|||
|
//CODE
|
|||
|
}
|
|||
|
```
|
|||
|
|
|||
|
## Другие рекомендации
|
|||
|
|
|||
|
* #### Используйте, когда вы знаете количество итераций, пока и делаете, когда вы этого не делаете.
|
|||
|
|
|||
|
* #### Используйте const, перейдите по значению / ссылке, когда это подходит. Это поможет сэкономить память.
|
|||
|
|
|||
|
* \#### Записывать const в caps, datatypes, начиная с T и переменных в нижнем регистре.
|
|||
|
|
|||
|
|
|||
|
```cpp
|
|||
|
const int MAX= 100; //Constant
|
|||
|
typedef int TVector[MAX]; //Data type
|
|||
|
TVector vector; //Vector
|
|||
|
|
|||
|
```
|