Skip to main content

Common Pitfalls & How to Avoid Them

As you progress on your coding journey, you'll inevitably make mistakes. That's a normal part of learning. This post highlights some of the most common pitfalls for both beginners and intermediate learners, so you can recognize and avoid them.

Part 1: Beginner Pitfalls​

These are traps that almost everyone falls into when they first start coding with AI.

  1. Over-trusting the AI: The AI can and will make mistakes. Never assume the code it generates is perfect. Always test it.
  2. Not Reading Error Messages: Error messages are your friends! They tell you exactly what's wrong. Don't just paste the error into the AI; try to understand it first.
  3. Copying Code Without Understanding: If you copy and paste code without knowing what it does, you haven't learned anything. You're just a typist. Always get the AI to explain the code to you.

Part 2: Intermediate Pitfalls​

As you get more comfortable, new and more subtle traps appear.

  1. Premature Optimization: Don't try to make your code super-efficient before it even works correctly. As the famous saying goes, "Make it work, make it right, make it fast" (in that order).
  2. Not Using Version Control Properly: Are you making big changes without committing them? Are your commit messages unhelpful like "stuff"? Use Git as it was intended: to save your progress at logical checkpoints.
  3. Skipping Documentation: You might think you'll remember what your code does in six months, but you won't. Write comments and READMEs. Your future self will thank you.
  4. Hardcoding Secrets: Never, ever, ever put API keys, passwords, or other secrets directly in your code. Use environment variables or a secrets management system (we'll cover this more in future posts).

How to Escape Bad Patterns​

  • Awareness: The first step is knowing what the pitfalls are. By reading this post, you're already ahead.
  • Code Reviews: Have someone else look at your code. They will spot things you missed.
  • Reflection: After you finish a project, take some time to think about what you could have done better.

Your Turn: Review Your Code​

Go back to your task manager project. Review your own code and see if you've fallen into any of these traps.

  • Did you test all the AI-generated code?
  • Are your Git commits frequent and well-messaged?
  • Is your code easy to understand? If not, can you add comments or refactor it?

Developing this self-awareness is a key step in becoming a professional developer.