How to Organize Code in a Go Project

Organize Go code by placing files in directories that match their import paths, starting with a go.mod file to define the module.

mkdir myproject
cd myproject
go mod init example.com/myproject
mkdir cmd mypkg
touch cmd/main.go mypkg/utils.go
echo 'package main' > cmd/main.go
echo 'package mypkg' > mypkg/utils.go

This structure separates executable entry points in cmd from reusable library code in mypkg, allowing the compiler to resolve imports correctly.

Think of your project like a library where books (code files) are organized by topic (directories). You start by creating a catalog (go.mod) that tells the system where to find everything. This setup lets you build programs and share code without confusion.