Стилевой кодовый минимум — различия между версиями
м (Новая страница: «Чтобы был качественный код, лучше следовать какому-то Style Guide, например гугловскому: http://googl...») |
м |
||
| Строка 29: | Строка 29: | ||
|- | |- | ||
| | | | ||
| − | + | <pre>if (...) | |
| − | + | { | |
| − | + | код... | |
| − | + | }</pre> | |
| | | | ||
| − | + | <pre>if (...) { | |
| − | + | код... | |
| − | + | }</pre> | |
Хотя, например, [http://perldoc.perl.org/perlstyle.html perlstyle] предлагает именно этот способ форматирования блоков, лично я не использую его и в Perl-коде, ибо неудобно. | Хотя, например, [http://perldoc.perl.org/perlstyle.html perlstyle] предлагает именно этот способ форматирования блоков, лично я не использую его и в Perl-коде, ибо неудобно. | ||
| | | | ||
| − | + | <pre>if (...) | |
| − | + | { | |
| − | + | код... | |
| − | + | } | |
| + | </pre> | ||
или | или | ||
| − | + | <pre>if (...) | |
| − | + | { | |
| − | + | код... | |
| − | + | }</pre> | |
|} | |} | ||
Версия 00:46, 30 мая 2011
Чтобы был качественный код, лучше следовать какому-то Style Guide, например гугловскому: http://google-styleguide.googlecode.com/svn/trunk/cppguide.xml
Но «чтобы не было говна», какому стилю следовать — не так важно, главное следовать хоть какому-то.
Как минимум:
Отступы
Я рекомендую использовать для отступов только пробелы и размер табуляции в 4 символа. НО не так важно, табы или пробелы и какой размер табуляции!
Важно, чтобы размер отступа был ОДИНАКОВЫЙ по всей программе и чтобы не было СМЕСИ табов с пробелами!
В Интернетах есть куча срачей на тему «табы vs пробелы», но когда в тред приходит человек, который говорит, что ему всё равно, хоть смесь — его точно бьют и те, и другие :)
Соответственно, если используем пробелы, в опциях редактора ОТКЛЮЧАЕМ табы! Если в редакторе есть режим «эмуляции половины таба», ОБЯЗАТЕЛЬНО отключите и его, он генерирует смесь табов и пробелов! (в Midnight Commander например есть)
Если используем табы, то ВСЕ ОТСТУПЫ ДЕЛАЕМ ИСКЛЮЧИТЕЛЬНО ТАБАМИ!
Блоки и функции
Во-первых, опять-таки их нужно хотя бы форматировать одинаково по всей программе. А во-вторых, фигурные скобочки должны быть на одном уровне с началом блока!
| Очень желательно: | Можно, но не нужно — визуально тело сливается с условием: | НИ В КОЕМ СЛУЧАЕ: |
|---|---|---|
if (...)
{
код...
}
|
if (...) {
код...
}
Хотя, например, perlstyle предлагает именно этот способ форматирования блоков, лично я не использую его и в Perl-коде, ибо неудобно. |
if (...)
{
код...
}
или if (...)
{
код...
}
|
