Если ты когда-то открывал .js, .php или .cpp файл и видел не абракадабру, а осмысленные конструкции — поздравляю, ты смотрел на исходный код. Это не магия и не тайная формула запуска Skynet, это просто человеческий текст, который компилятор потом пережёвывает в нечто исполняемое. Для нас, программистов, это рабочий инструмент, для компьютера — сырьё.

Что вообще такое исходный код?

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

Кто с ним работает и зачем?

С исходником возятся:

  • программисты (пишут, комментируют, проклинают);
  • инструменты (собирают, форматируют, документируют);
  • студенты (мучаются, потому что читают чужое без комментариев).

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

Повторное использование и модули

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

Переносимость

Код, который запускается только на твоей машине, — это мусор. Переносимость важна: другая ОС, другая архитектура — а всё должно запускаться. Потому и пишем по правилам, а не как бог на душу положит.

Инструменты

Нормальный человек не пишет всё в Блокноте. Есть IDE, системы контроля версий, автотесты, линтеры и прочий софт, который помогает не свихнуться и не потерять полгода работы из-за случайного rm -rf.

Качество кода — это не перфекционизм, это необходимость

Компьютеру пофиг на твой стиль. Он всё равно всё проглотит. А вот другому разработчику — нет. Поэтому:

  • читаемость — must have, не повод для гордости;
  • простота отладки — экономит часы;
  • без мёртвого кода — убирай за собой;
  • переносимость — думай на шаг вперёд.

Итого

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