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