Go's Struct Embedding Trap: Composition That Deceives Like Inheritance

Go developers from class-based languages often mistake struct embedding for inheritance, but embedded methods run on the embedded type's receiver, not the outer struct. This critical distinction—that embedding is composition with method promotion, not inheritance—prevents unexpected behavior. Understanding when and how methods are resolved in embedded types is essential for writing predictable Go code.