97 Things Every Programmer Should Know
  • 97 Things Every Programmer Should Know
  • LANGS
  • 97 Things Every Programmer Should Know
    • Summary
    • Act with Prudence
    • Apply Functional Programming Principles
    • Ask "What Would the User Do?" (You Are not the User)
    • Automate Your Coding Standard
    • Beauty Is in Simplicity
    • Before You Refactor
    • Beware the Share
    • The Boy Scout Rule
    • Check Your Code First before Looking to Blame Others
    • Choose Your Tools with Care
    • Code in the Language of the Domain
    • Code Is Design
    • Code Layout Matters
    • Code Reviews
    • Coding with Reason
    • A Comment on Comments
    • Comment Only What the Code Cannot Say
    • Continuous Learning
    • Convenience Is not an -ility
    • Deploy Early and Often
    • Distinguish Business Exceptions from Technical
    • Do Lots of Deliberate Practice
    • Domain-Specific Languages
    • Don't Be Afraid to Break Things
    • Don't Be Cute with Your Test Data
    • Don't Ignore that Error!
    • Don't Just Learn the Language, Understand its Culture
    • Don't Nail Your Program into the Upright Position
    • Don't Rely on "Magic Happens Here"
    • Don't Repeat Yourself
    • Don't Touch that Code!
    • Encapsulate Behavior, not Just State
    • Floating-point Numbers Aren't Real
    • Fulfill Your Ambitions with Open Source
    • The Golden Rule of API Design
    • The Guru Myth
    • Hard Work Does not Pay Off
    • How to Use a Bug Tracker
    • Improve Code by Removing It
    • Install Me
    • Inter-Process Communication Affects Application Response Time
    • Keep the Build Clean
    • Know How to Use Command-line Tools
    • Know Well More than Two Programming Languages
    • Know Your IDE
    • Know Your Limits
    • Know Your Next Commit
    • Large Interconnected Data Belongs to a Database
    • Learn Foreign Languages
    • Learn to Estimate
    • Learn to Say "Hello, World"
    • Let Your Project Speak for Itself
    • The Linker Is not a Magical Program
    • The Longevity of Interim Solutions
    • Make Interfaces Easy to Use Correctly and Hard to Use Incorrectly
    • Make the Invisible More Visible
    • Message Passing Leads to Better Scalability in Parallel Systems
    • A Message to the Future
    • Missing Opportunities for Polymorphism
    • News of the Weird: Testers Are Your Friends
    • One Binary
    • Only the Code Tells the Truth
    • Own (and Refactor) the Build
    • Pair Program and Feel the Flow
    • Prefer Domain-Specific Types to Primitive Types
    • Prevent Errors
    • The Professional Programmer
    • Put Everything Under Version Control
    • Put the Mouse Down and Step Away from the Keyboard
    • Read Code
    • Read the Humanities
    • Reinvent the Wheel Often
    • Resist the Temptation of the Singleton Pattern
    • The Road to Performance Is Littered with Dirty Code Bombs
    • Simplicity Comes from Reduction
    • The Single Responsibility Principle
    • Start from Yes
    • Step Back and Automate, Automate, Automate
    • Take Advantage of Code Analysis Tools
    • Test for Required Behavior, not Incidental Behavior
    • Test Precisely and Concretely
    • Test While You Sleep (and over Weekends)
    • Testing Is the Engineering Rigor of Software Development
    • Thinking in States
    • Two Heads Are Often Better than One
    • Two Wrongs Can Make a Right (and Are Difficult to Fix)
    • Ubuntu Coding for Your Friends
    • The Unix Tools Are Your Friends
    • Use the Right Algorithm and Data Structure
    • Verbose Logging Will Disturb Your Sleep
    • WET Dilutes Performance Bottlenecks
    • When Programmers and Testers Collaborate
    • Write Code as If You Had to Support It for the Rest of Your Life
    • Write Small Functions Using Examples
    • Write Tests for People
    • You Gotta Care About the Code
    • Your Customers Do not Mean What They Say
  • 97 چیزی که هر برنامه نویس باید بداند
    • فهرست چیزها!
    • بدهی فنی (Technical Debt)
    • برنامه نویسی تابعی یا Functional Programming
    • نیاز کاربر چیست؟
    • استاندارهای کدنویسی
    • ساده زیباست
    • آشنایی با مفهوم ریفکتورینگ در کدنویسی
    • نظافت را رعایت کنید!
    • پیش از آن که دیگران را متهم کنید، کد خود را چک کنید!
    • انتخاب ابزار مناسب
    • برنامه های خود را به زبان مشتریان بنویسید!
    • طرح‌های خود را بی‌نقص کنید
    • به چیدمان کدها توجه کنید!
    • نقد و بررسی کدها
    • کامنت‌گذاری را فراموش نکنید
    • تنها توضیحاتی را بنویسید که کدهایتان قادر به شرح آنها نباشند!
    • از کدهای قبلی خود در شرایط مناسب مجدداً استفاده کنید
    • همواره در حال یادگیری موضوعات جدید باشید
    • ویژگی‌های یک API با طراحی مناسب
    • از ابتدای کار توسعهٔ اپلیکیشن خود روی فرآیند نصب و دیپلوی آن به طور پیوسته کار کنید
    • مدیریت اکسپشن ها
    • تمرین آگاهانه، لازمهٔ حرفه‌ای شدن است!
    • پشت هر خط از کد شما می‌بایست یک منطق وجود داشته باشد!
    • مفهوم DSL چیست و چرا آشنایی با آن در حوزهٔ برنامه‌نویسی اهمیت دارد؟
    • از ساختارشکنی نترسید!
    • برای تست نرم‌افزار از دیتای واقعی استفاده کنید
    • حتی یک ارور را هم نادیده نگیرید!
    • فرهنگ استفاده از یک زبان برنامه‌نویسی را در کنار سینتکس آن بیاموزید
    • اکسپش‌ها را به راحت‌ترین شکل ممکن هَندل کنید
    • فرایند توسعه یک نرم‌افزار خوب اصلاً شانسی نیست
    • آشنایی با قانون DRY
    • آشنایی با مراحل توسعهٔ نرم‌افزار
    • به‌کارگیری درست از اصول برنامه‌نویسی شیٔ‌گرا
    • اعداد اعشاری با خطای محاسباتی در کامپیوتر ذخیره می‌شوند
    • جاه طلبی خود را با شرکت در پروژه های متن باز برآروده کنید!
    • قانون طلایی طراحی API
    • کسی که چند سال است کدنویسی می‌کند، اصلاً علامهٔ دهر نیست!
    • کار زیاد ضمانت موفقیت در برنامه‌نویسی نیست!
    • چگونه به یک باگ نگاه کنیم؟
    • با حذف کدهای اضافی، سورس‌کد خود را بهبود بخشید
    • برنامه‌هایی که می‌نویسید را کاربرپسند کنید
    • فرایندهای برون برنامه‌ای، زمان پاسخگویی نرم‌افزار را تحت‌الشعاع خود قرار می‌دهند
    • بیلد (Build) اصولی ارائه کنید
    • استفادهٔ بهینه از ابزارهای کامندلاینی
    • یادگیری هم‌زمان بیش از یک زبان برنامه‌نویسی
    • محیط کد نویسی (IDE) خود را مثل موم در دست بگیرید
    • ا محدودیت‌های خود دست و پنجه نرم کنید
    • همواره بدانید چه چیزی را قرار است کامیت کنید
    • آشنایی با نحوهٔ به‌کارگیری دیتابیس‌های رابطه‌ای
    • آشنایی با مهارت‌های ارتباطی و فراگیری زبان‌های خارجی
    • خود را با مهارت تخمین زدن تجهیز کنید!
    • کدام یک؟ IDE یا Editor ، مسأله این است!
    • ارسال پیام خطا به دولوپر توسط نرم‌افزار
    • چیزهای اضافی را لود نکنید!
    • چه‌موقع و چگونه از راه‌کارهای موقتی در کدنویسی استفاده کنیم؟
    • استفادهٔ نادرست از اینترفیس‌ها را غیرممکن سازید
    • تا حد ممکن همه‌ چیز را شفاف‌سازی کنید
    • ضرورت آشنایی با مفاهیم کانکارنسی و پاراللیزم
    • یافتن راه‌کارهای ساده برای مشکلات سخت
    • دولوپری که نداند Polymorphism چیست، دولوپر نیست!
    • تستر‌های نرم‌افزار دشمن دولوپرها نیستند!
    • همواره یک نسخه از نرم‌افزار برای ریلیس داشته باشید
    • فقط سورس‌کد است که حرف اول و آخر را می‌زند
    • فقط کد نزنید بلکه Build Process را نیز مدنظر قرار دهید
    • اهمیت برنامه‌نویسی دونفره
    • آشنایی با تفاوت Static Typing و Dynamic Typing در برنامه‌نویسی
    • تا حد ممکن از نمایش ارورها برای کاربر اجتناب کنید!
    • به چه برنامه‌نویسی حرفه‌ای می‌گویند؟
    • از ورژن کنترل غافل نشوید!
    • ماوس و کیبورد را کنار بگذارید!
    • کدخوانی کنید!
    • تعاملات اجتماعی کلید موفقیت است!
    • تا حد ممکن دست به اختراع مجدد چرخ نزنید!
    • تا حد ممکن از Singleton Pattern استفاده نکنید
    • وابستگی‌های زیاد دشمن ریفکتورینگ هستند!
    • هرچه تعداد خطوط کد کمتر، بهتر!
    • آشنایی با قانون Single Responsibility
    • همه‌ چیز با یک آری شروع می‌شود!
    • تا حد ممکن همه‌ چیز را خودکار کنید
    • شنایی با مزایای ابزارهای تحلیل سورس‌کد
    • در تست نرم‌افزار فقط رفتار مورد انتظار را بسنجید
    • تست‌ها علاوه بر صحیح بودن، می‌بایست دقیق هم باشند
    • تست نرم‌افزار و سورس‌کد را آخر شب‌ها و آخر هفته‌ها انجام دهید!
    • مقایسه‌ای مابین مهندسین نرم‌افزار و دیگر مهندسان
    • از نوشتن کدهای اضافی پرهیز کنید
    • اهمیت برنامه‌نویسی دونفره در کدنویسی را هرگز نادیده نگیرید
    • منفی در مفنی می‌شود مثبت!
    • کدنویسی تمیز و اصولی یک باید است
    • ابزارهای یونیکسی دوست دولوپرها هستند!
    • استفادهٔ درست از الگوریتم‌ها و دیتا استراکچرها
    • با لاگ‌گیری Verbose دچار دردسر خواهید شد!
    • درک تفاوت مفاهیم DRY و WET در کدنویسی بهینه
    • تعامل مابین دولوپرها و تسترها
    • طوری کد بزنید که گویی قرار است تا آخر عمر سورس‌کدتان را ساپورت کنید!
    • تا حد ممکن فانکشن‌های کوچک بنویسید
    • برای دولوپرها تست بنویسید نه برای ماشین‌ها!
    • مراقب سورس‌کد باشید!
    • منظور مشتریان شما چیزی نیست که می گویند!
  • 97 вещей, которые должен знать каждый программист
    • Summary
    • Автоматизируйте стандарт кодирования
    • Будьте предусмотрительны
    • В линкере нет никакой магии
    • Ваш заказчик говорит не то, что думает
    • Взаимодействие между процессами влияет на время отклика
    • Выучить язык - значит понять его культуру
    • Дайте проекту голос
    • Две ошибки могут взаимокомпенсировать друг друга (и найти это - очень тяжело)
    • Делайте невидимое видимым
    • Делайте ревью кода
    • Думаете, это никто не увидит?
    • Единственный исполняемый файл
    • Заботьтесь о коде
    • Золотое правило дизайна API
    • Изучайте гуманитарные науки
    • Изучайте другие языки программирования
    • Изучайте иностранные языки!
    • Изучите ограничения
    • Изучите свой IDE
    • Инкапсулируйте не только состояние, но и поведение
    • Используйте правильные алгоритмы и структуры данных
    • Используйте преимущества анализаторов кода
    • Используйте типы из вашей предметной области
    • Когда программисты и тестеры объединяются
    • Комментируйте лишь то, что не ясно из кода
    • Красота и простота
    • Мины замедленного действия
    • Миф о гуру
    • Много данных? Используйте СУБД!
    • Мыслите состояниями
    • Наблюдайте за пользователями
    • Научитесь пользоваться командной строкой
    • Начинайте с "да"
    • Начните отладку процесса установки как можно раньше
    • Не бойтесь что-нибудь сломать!
    • Не забывайте о "Hello, world"
    • Не игнорируйте ошибки.
    • Не надейтесь на магию
    • Не повторяйтесь
    • Не работайте сверхурочно
    • Не трогай это!
    • Непрерывное обучение
    • Нет ничего более постоянного, чем временное
    • О комментариях
    • О пользе изобретения велосипеда
    • Обмен сообщений вместо разделяемой памяти
    • Одна голова - хорошо, а две - лучше
    • Основы bug tracking-a
    • Осознанная практика
    • Осторожнее с повторным использованием!
    • Осторожно выбирайте внешние модули
    • Отойдите от клавиатуры
    • Перегруженный журнал ошибок может лишить вас сна
    • Перед началом рефакторинга
    • Пишите код так, как будто вы будете сопровождать его до конца жизни
    • Пишите маленькие функции, используя примеры
    • Пишите тесты для людей
    • Планируйте свой следующий коммит
    • Поддерживайте чистоту кода
    • "Подмоченный" код сложнее оптимизировать
    • Подозреваете ошибку в компиляторе? Проверьте получше свой код!
    • Позвольте трупу упасть
    • Помещайте все в систему контроля версий
    • Послание в будущее
    • Правило туриста
    • Предотвращайте ошибки
    • Применяйте принципы функционального программирования
    • Принцип единственности ответственности
    • Программирование - это дизайн
    • Программируйте на языке предметной области
    • Программируйте осознанно
    • Программист - профессионал
    • Простота от уменьшения
    • Разделяйте технические и логические исключения
    • Разметка кода важна!
    • Сделайте процесс сборки своим
    • Сопротивляйтесь использованию Singleton
    • Состояние потока и парное программирование
    • Тестеры - лучшие друзья программистов
    • Тестирование - обязательный этап разработки
    • Тестируйте по ночам и в выходные
    • Тестируйте требуемое поведение, а не случайное
    • Тесты должны быть точными
    • Только код расскажет всю правду
    • Убунту-программирование
    • Удобство?
    • Удовлетворяйте свои амбиции на проектах open source
    • Упущенные возможности полиморфизма
    • Установи меня
    • Учитесь оценивать
    • Хороший интерфейс: легко использовать правильно, сложно использовать неправильно
    • Числа с плавающей точкой - не действительные!
    • Читайте код
    • Чтобы улучшить код, удалите его
    • Шаг назад - и автоматизируйте, автоматизируйте, автоматизируйте!
    • Юникс-утилиты - это ваши друзья
    • Языки предметной области
  • Her Yazılımcının Bilmesi Gereken 97 Şey
    • Summary
    • Sağduyulu hareket edin
    • Fonksiyonel Programlama İlkelerini Uygulayın
    • "Kullanıcı Ne Yapar?" Diye Sor (Kullanıcı Siz değilsiniz)
    • Kodlama Standardınızı Otomatikleştirin
    • Güzellik Sadelikte
    • Yeniden Düzenlemeden Önce
    • Paylaşıma Dikkat Edin
    • İzci Kuralı
    • Başkalarını Suçlamadan Önce Kodunuzu Kontrol Edin
    • Araçlarınızı Özenle Seçin
    • Domain Dilindeki Kod
    • Kod Tasarımdır
    • Kod Düzeni Önemlidir
    • Kod İncelemeleri
    • Akıllı Kodlama
    • Yorumlar Üzerine Bir Yorum
    • Yalnızca Kodun Söyleyemediklerini Yorumlayın
    • Devamlı öğrenme
    • Kolaylık bir yetenek değildir
    • Erken ve Sıkça Dağıtın
    • İş İstisnalarını Tekniklerden Ayırın
    • Bol Bol Kasıtlı Uygulama Yapın
    • Etki Alanına Özgü Diller
    • Bir Şeyleri Kırmaktan Korkma
    • Test Verilerinizle Sevimli Olmayın
    • Hatayı Görmezden Gelmeyin!
    • Sadece Dili Öğrenmeyin, Kültürünü Anlayın
    • Programınızı Dik Konumda Çivilemeyin
    • "Burada Sihir Olur"a Güvenmeyin
    • Kendinizi Tekrar Etmeyin (Don't Repeat Yourself - DRY)
    • O Koda Dokunma!
    • Sadece Durumu Değil, Davranışı Kapsülleyin
    • Kayan Noktalı Sayılar Gerçek Değil
    • Açık Kaynak ile Hedeflerinizi Gerçekleştirin
    • API Tasarımının Altın Kuralı
    • Guru Efsanesi
    • Sıkı Çalışmanın Getirisi Yok
    • Hata İzleyici Nasıl Kullanılır
    • Kodu Kaldırarak İyileştirin
    • Beni Kur
    • Süreçler Arası İletişim Uygulama Yanıt Süresini Etkiler
    • Yapıyı Temiz Tutun
    • Komut Satırı Araçlarını Nasıl Kullanacağınızı Bilin
    • İkiden Fazla Programlama Dilini İyi Bilin
    • IDE'nizi Bilin
    • Sınırlarınızı Bilin
    • Bir Sonraki İşleminizi(Commit) Bilin
    • Büyük Birbirine Bağlı Veriler Bir Veritabanına Aittir
    • Yabancı Diller Öğrenin
    • Tahmin Etmeyi Öğrenin
    • "Merhaba Dünya" Demeyi Öğrenin
    • Bırakın Projeniz Kendi Adına Konuşsun
    • Bağlayıcı Sihirli Bir Program Değildir
    • Geçici Çözümlerin Uzun Ömrü
    • Arayüzlerin Doğru Kullanımını Kolay ve Yanlış Kullanımını Zorlaştırın
    • Görünmezi Daha Görünür Hale Getirin
    • Mesaj Geçişi, Paralel Sistemlerde Daha İyi Ölçeklenebilirlik Sağlar
    • Geleceğe Mesaj
    • Polimorfizm için Kaçırılan Fırsatlar
    • Tuhaf Haber: Testçiler Arkadaşlarınızdır
    • Tek İkili
    • Sadece Kod Gerçeği Söyler
    • Yapıya Sahip Olun (ve Yeniden Düzenleyin)
    • Programı Eşleştirin ve Akışı Hissedin
    • Domain Alanına Özgü Türleri İlkel Türlere Tercih Edin
    • Hataları Önle
    • Profesyonel Yazılımcı
    • Her Şeyi Sürüm Kontrolü Altına Alın
    • Fareyi Yere Bırakın ve Klavyeden Uzaklaşın
    • Kodu Okuyun
    • Beşeri Bilimleri Okuyun
    • Tekerleği Sıklıkla Yeniden İcat Edin
    • Singleton Modelin Cazibesine Kapılma
    • Performansa Giden Yol Kirli Kod Bombalarıyla Dolu
    • Sadelik Azaltmadan Gelir
    • Tek Sorumluluk İlkesi(The Single Responsibility)
    • Evet'ten Başlayın
    • Geri Adım Atın ve Otomatikleştirin, Otomatikleştirin, Otomatikleştirin
    • Kod Analiz Araçlarından Yararlanın
    • Tesadüfi Davranış Değil, Gerekli Davranış Testi
    • Kesin ve Somut Test Edin
    • Uyurken (ve Hafta Sonları) Test Edin
    • Test, Yazılım Geliştirmenin Mühendislik Zorluğudur
    • Durumlarda Düşünmek
    • İki Kafa Çoğu Zaman Bir Kafadan Daha İyidir
    • İki Yanlış Bir Doğru Yapabilir (ve Düzeltilmesi Zordur)
    • Arkadaşlarınız İçin Ubuntu Kodlama
    • Unix Araçları Arkadaşlarınızdır
    • Doğru Algoritmayı ve Veri Yapısını Kullanın
    • Ayrıntılı Log Kaydı Uykunuzu Bozacak
    • WET Performans Darboğazlarını Azaltıyor
    • Programcılar ve Test Uzmanları İşbirliği Yaptığında
    • Hayatınız Boyunca Desteklemek Zorundaymışsınız Gibi Kod Yazın
    • Örnekleri Kullanarak Küçük Fonksiyonlar Yazın
    • İnsanlar için Testler Yaz
    • Kodu Önemsemelisiniz
    • Müşterileriniz Ne Dediklerini Kastetmez
Powered by GitBook
On this page
  1. 97 Things Every Programmer Should Know

Don't Ignore that Error!

I was walking down the street one evening to meet some friends in a bar. We hadn't shared a beer in some time and I was looking forward to seeing them again. In my haste, I wasn't looking where I was going. I tripped over the edge of a curb and ended up flat on my face. Well, it serves me right for not paying attention, I guess.

It hurt my leg, but I was in a hurry to meet my friends. So I pulled myself up and carried on. As I walked further the pain was getting worse. Although I'd initially dismissed it as shock, I rapidly realized there was something wrong.

But I hurried on to the bar regardless. I was in agony by the time I arrived. I didn't have a great night out, because I was terribly distracted. In the morning I went to the doctor and found out I'd fractured my shin bone. Had I stopped when I felt the pain, I'd've prevented a lot of extra damage that I caused by walking on it. Probably the worst morning after of my life.

Too many programmers write code like my disastrous night out.

Error, what error? It won't be serious. Honestly. I can ignore it. This is not a winning strategy for solid code. In fact, it's just plain laziness. (The wrong sort.) No matter how unlikely you think an error is in your code, you should always check for it, and always handle it. Every time. You're not saving time if you don't: You're storing up potential problems for the future.

We report errors in our code in a number of ways, including:

  • Return codes can be used as the resulting value of a function to mean "it didn't work." Error return codes are far too easy to ignore. You won't see anything in the code to highlight the problem. Indeed, it's become standard practice to ignore some standard C functions' return values. How often do you check the return value from printf?

  • errno is a curious C aberration, a separate global variable set to signal error. It's easy to ignore, hard to use, and leads to all sorts of nasty problems — for example, what happens when you have multiple threads calling the same function? Some platforms insulate you from pain here; others do not.

  • Exceptions are a more structured language-supported way of signaling and handling errors. And you can't possibly ignore them. Or can you? I've seen lots of code like this:

try {
    // ...do something...
}
catch (...) {} // ignore errors

The saving grace of this awful construct is that it highlights the fact you're doing something morally dubious.

If you ignore an error, turn a blind eye, and pretend that nothing has gone wrong, you run great risks. Just as my leg ended up in a worse state than if I'd stopped walking on it immediately, plowing on regardless can lead to very complex failures. Deal with problems at the earliest opportunity. Keep a short account.

Not handling errors leads to:

  • Brittle code. Code that's filled with exciting, hard-to-find bugs.

  • Insecure code. Crackers often exploit poor error handling to break into software systems.

  • Poor structure. If there are errors from your code that are tedious to deal with continually, you probably have a poor interface. Express it so that the errors are less intrusive and the their handling is less onerous.

Just as you should check all potential errors in your code, you need to expose all potentially erroneous conditions in your interfaces. Do not hide them, pretending that your services will always work.

Why don't we check for errors? There are a number of common excuses. Which of these do you agree with? How would you counter each one?

  • Error handling clutters up the flow of the code, making it harder to read, and harder to spot the "normal" flow of execution.

  • It's extra work and I have a deadline looming.

  • I know that this function call will never return an error (printf always works, malloc always returns new memory — if it fails we have bigger problems...).

  • It's only a toy program, and needn't be written to a production-worthy level.

PreviousDon't Be Cute with Your Test DataNextDon't Just Learn the Language, Understand its Culture

Last updated 2 years ago

By

Pete Goodliffe