Преисполненные в себе джуны, или как самому найти ошибку и не задавать глупые вопросы

Каждый начинающий (и не только) разработчик сталкивался и будет сталкиваться с ошибками, допущенными в своём коде. Это абсолютно нормально и в этом нет ничего страшного: вас не будут бить палкой, ваша компетентность не понизится, а ошибки вас не съедят. Правда, только при условии, что вы не будете на каждую проблему с отступами или пропущенную точку с запятой бежать к кому-то за помощью, ведь рано или поздно вам откажут или проигнорируют, а как оказывается — умение искать и устранять ошибки самостоятельно довольно сильно хромает у большинства начинающих, и поэтому этот гайд и вышел в свет. Благодаря списку инструкций ниже, ваш КПД увеличится, а кол-во времязатратных и, вероятно, бессмысленных сообщений в чатах будет стремиться к нулю.

Как найти ошибку

Просто загуглите

Гугл — довольно мощный инструмент в наше время. В нём возможно найти 99% ответов на все вопросы, особенно, если ты начинающий программист.

Просто введите свой вопрос. Вот несколько шаблонов:

<название_языка_или_библиотеки_или_фреймворка> <вопрос>

Примеры: "python как декодировать строку в utf-8"; "flask как принимать query params"; "javascript как профильтровать список словарей по ключам"

<название_языка_или_библиотеки_или_фреймворка> <ошибка>

Примеры: "python IndentationError: unindent does not match any outer indentation error"; "django3.1 django.db.utils.OperationalError: could not connect to server"; "gulp prompt_status:5: command not found: wc"

Не помогло?

Загуглите ещё раз

Умение формулировать запросы в поисковой системе тоже навык. Не всегда удаётся с первого, второго, а то и с 5-го раза найти ответ на свой вопрос, поэтому следует уметь интерпретировать ваш запрос. Меняйте ключевые слова, тип и формулировку предложения, немаловажно выкинуть из лога ошибки персонализированные данные, например, навряд ли кто-то столкнулся с ошибкой, включающую в себя название вашего сервера, переменной или токен (храните все секретные данные в переменных окружения!), только если это не значения по умолчанию (например, 5432 порт для postgres).

Также, крайне рекомендую делать все запросы в поисковик на английском языке, так как попросту англоязычное сообщество охватывает весь мир, и вероятность нахождения ответа вырастает в разы. На случай, если вы не знаете английский (а пора бы), существуют сайты с машинным переводом англоязычных форумов, в частности, StackOverflow, например, coderoad.ru

Также, вы можете найти тематический чат в @it_chats и с помощью поиске сообщений провести такую же операцию. Как уже упоминалось, есть немалый шанс того, что кто-то уже сталкивался с данной проблемы.

Лучший знаток вашего кода — вы

Если всё же вы не смогли найти ответ в гугле, несмотря на многочисленные попытки — просмотрите свой код ещё раз. Если ваша проблема основывается на выброшенной ошибке — просмотрите лог ошибки полностью. Зачастую, в нем хранится строчка-триггер в вашем коде, которая и есть причиной ошибки.  

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

Требуется помощь друга

Если все же вы столкнулись с тем, что ни один из вышеперечисленных пунктов вам не помог и вы не можете самостоятельно решить проблему, то формулируйте свои вопросы в личных диалогах или чатах так, чтобы человеку была максимально ясна ваша проблема и у него не появилось отвержения вам помочь. Если вы нашли человека в чате, то не пишите ему в личные сообщения без его разрешения. Формируйте свои мысли одним сообщением, без лишних вежливых прелюдий и мета-вопросов. Не тратьте ваше и чужое время на зачастую ненужный "добрый" тон, перешедший из реального общения (подробнее об этом тут: nometa.xyz, neprivet.ru). Не присылайте любые фото чего-либо, делайте скриншоты. Вставки кода обрамляйте в тройные обратные апострофы (backtick) ` (Ctrl + Shift + K/Command + Shift + K), если кода более 10-15 строк - отправляйте с помощью dpaste.org (вставляете код > выбираете нужный язык программирования > сохраняете > копируете ссылку)

Шаблон хорошо сформулированного вопроса:

Использую А, есть задача B, нужно реализовать в виде С, я пытался D, гуглил E, читал, что F, но не получается, потому, что X. 

Список всех it-чатов на различные тематики: @it_chats

Послесловие

Надеюсь, данный гайд поможет вам, сохранит время людей, и сбережёт вашу психику, спасибо.