Вопросы с тегом «coding-standards»

Стандарты кодирования или соглашения о кодировании - это наборы правил или руководств, предназначенных для управления процессом производства кода в программном проекте. Обычно они основаны на лучших отраслевых практиках или общепринятых соглашениях. Они включают в себя соглашения об именах, стиль, запрещенные функции и многое другое.

1055
Откуда пришло понятие «только одно возвращение»?

Я часто общаюсь с программистами, которые говорят: « Не помещайте несколько операторов return в один и тот же метод». Когда я прошу их рассказать мне причины, все, что я получаю, это « Стандарт кодирования говорит об этом » или « Это сбивает с толку ». Когда они показывают мне решения с помощью...

194
Неправильно ли использовать логический параметр для определения поведения?

Время от времени я видел практику, которая «чувствует» неправильную, но я не могу четко сформулировать, что в ней плохого. Или, может быть, это просто мое предубеждение. Поехали: Разработчик определяет метод с логическим значением в качестве одного из его параметров, и этот метод вызывает другой, и...

145
Почему дядя Боб предлагает не записывать стандарты кодирования, если вы можете избежать этого?

В то время как я читал этот вопрос , самый популярный ответ цитировал дядю Боба по стандартам кодирования , но я был смущен этим советом: Не записывайте их, если можете этого избежать. Скорее пусть код будет способом, которым стандарты собраны. Это подпрыгнуло в моем мозгу, но я не мог найти место,...

142
Стандарт кодирования для ясности: прокомментировать каждую строку кода?

Я работал в магазинах, которые производят жизненно важное программное обеспечение, и я имел дело с правилами комментирования, которые должны были сделать код читабельным и потенциально спасти жизни. Однако, по моему опыту, требование превращаться в смертельно опасную рутину, чтобы быть убранным из...

126
Почему большинство из нас использует 'i' в качестве переменной счетчика цикла?

Кто-нибудь задумывался над тем, почему многие из нас повторяют один и тот же шаблон, используя одни и те же имена переменных? for (int i = 0; i < foo; i++) { // ... } Кажется , больше всего кода я когда - либо смотрел на использований i, j, kи так далее , как итерационных переменных. Я полагаю,...

125
Может ли функция быть слишком короткой?

Всякий раз, когда я обнаруживаю, что пишу одну и ту же логику более одного раза, я обычно встраиваю ее в функцию, поэтому в моем приложении есть только одно место, где я должен поддерживать эту логику. Побочным эффектом является то, что я иногда получаю одну или две строчные функции, такие как:...

107
Метод против функции против процедуры

Простой вопрос, но я часто слышу эти три термина, определенные с такой жестокостью, но которые, как мне было известно, означали разные вещи на протяжении многих лет. Каковы «правильные» определения «процедур», «методов», «функций», «подпрограмм» и т....

101
Какая польза от использования венгерской нотации?

Одна из вещей, с которой я борюсь, это не использование венгерской нотации. Я не хочу идти к определению переменной, чтобы посмотреть, какой это тип. Когда проект становится обширным, приятно иметь возможность просматривать переменную с префиксом 'bool' и знать, что он ищет значение true / false...

91
Как я могу избежать ощущения, будто полностью перестроив свою программу с нуля, я бы сделал это намного лучше? [закрыто]

Я изучил значительный объем программирования, однако он всегда находился в научной среде (не в области компьютерных наук), полностью самоучка, и никто не мог направить меня в правильном направлении. Таким образом, мое путешествие по кодированию было ... грязным. Теперь я заметил, что всякий раз,...

85
Насколько важно уменьшить количество строк в коде?

Я разработчик программного обеспечения, который работает на J2SE (ядро Java). Часто во время наших обзоров кода нас просят уменьшить количество строк в нашем коде. Речь идет не об удалении избыточного кода, а о следовании стилю, который фокусируется на выполнении одних и тех же вещей с меньшим...

79
Одинарные кавычки против двойных кавычек [закрыто]

Я только начал работу, где я пишу Python после того, как пришел из Java-фона, и я заметил, что другие разработчики склонны заключать строки в кавычки, используя одинарные кавычки ( '') вместо двойных кавычек ( ""). Например: line1 = 'This is how strings typically look.' line2 = "Not like this."...

78
Руководство по кодированию: методы не должны содержать более 7 операторов?

Я просматривал Рекомендации по кодированию AvSol для C #, и я согласен почти со всем, но мне действительно интересно посмотреть, что другие думают об одном конкретном правиле. AV1500 Методы не должны превышать 7 операторов. Метод, который требует более 7 операторов, выполняет слишком много или...

77
Худший стандарт кодирования, которому вы когда-либо должны были следовать? [закрыто]

Приходилось ли вам когда-либо работать над стандартами кодирования, которые: Сильно снизилась ваша производительность? Первоначально были включены по уважительным причинам, но были сохранены еще долго после того, как первоначальная проблема стала неактуальной Были ли в списке так долго, что было...

75
Есть ли смысл включать «журнал изменений» в каждый файл кода, когда вы используете контроль версий?

У меня сложилось впечатление, что система контроля версий избавляет от необходимости делать «логи изменений» повсюду в коде. Я часто видел продолжение использования журналов изменений, включая большие длинные блоки в начале хранимых процедур с большим разделом, заблокированным для изменений в...

73
Должны ли имена интерфейсов начинаться с префикса «I»?

Я читал « Чистый код » Роберта Мартина, чтобы, надеюсь, стать лучшим программистом. Хотя до сих пор ни один из них не был действительно новаторским, это заставило меня по-другому думать о том, как я проектирую приложения и пишу код. Есть одна часть книги, с которой я не только не согласен, но и не...

72
Что ХХХ означает в комментарии? [закрыто]

Что люди обычно имеют в виду, когда вы видите XXXв комментарии. Иногда я увижу такой комментарий: # XXX - This widget really should frobulate the whatsit Конечно, я могу сказать, что означает комментарий, но что обычно означает XXX? Это говорит "Это взлом" или, может быть, "Мы должны вернуться к...