Friday, July 12, 2024

Create a ‘Hello World’ Program in Go: A Beginner’s Guide

Last Updated on July 7, 2024


Learning a programming language is essential for anyone interested in technology and software development.

It is the foundation of many applications and systems that we use today.

Go, also known as Golang, is a beginner-friendly programming language that offers simplicity and efficiency in its syntax and design.

It is gaining popularity due to its ease of use and powerful capabilities.

The purpose of this blog post is to provide a step-by-step guide for beginners in creating a “Hello World” program in Go.

This program serves as the most basic introduction to any programming language, allowing beginners to become familiar with the syntax and structure.

By walking beginners through the process of creating a “Hello World” program in Go, this blog post aims to instill confidence in newcomers and help them embark on their programming journey. It will demystify the process and provide clear instructions for each step.

Throughout the blog post, we will cover the necessary steps and provide code examples to illustrate the concepts.

We will explain the basics of installing and setting up the Go environment, writing the code, and running the program.

By the end of this post, beginners should be able to write and execute a “Hello World” program in Go, understanding the fundamentals of the language and feeling motivated to continue their learning journey in the world of programming.

Understanding Go

Go, also known as Golang, is a statically typed, compiled programming language designed by Google.

It aims to simplify coding while ensuring high performance and efficiency.

As a beginner, understanding Go will open doors to creating robust applications with ease.

Introduction to the Go Programming Language

Go was created by Google engineers Robert Griesemer, Rob Pike, and Ken Thompson.

They wanted a language that combined the ease of programming of scripting languages with the efficiency and safety of statically typed, compiled languages.

Released in 2009, Go has since become a popular choice for developers due to its simplicity, reliability, and strong performance.

Key Features and Advantages of Go for Beginners

1. Simple Syntax

Go’s syntax is straightforward and easy to learn. This simplicity makes it accessible for beginners:

  • No Semicolons: Unlike languages like C, Go doesn’t require semicolons to end statements.

  • Clear Error Messages: Go provides clear, concise error messages that help in debugging.

2. Fast Compilation

Go compiles quickly, which speeds up the development process. Fast compilation:

  • Enhances Productivity: Allows developers to test and iterate code rapidly.

  • Improves Efficiency: Reduces waiting time, making coding sessions more productive.

3. Strong Performance

Go’s performance is comparable to C and C++:

  • Efficient Execution: Compiled code runs swiftly, making Go suitable for performance-critical applications.

  • Concurrency Support: Go’s built-in support for concurrent programming with goroutines simplifies handling multiple tasks simultaneously.

4. Built-in Testing

Go includes a testing framework in its standard library:

  • Simplifies Testing: Developers can write and execute tests easily without additional tools.

  • Ensures Code Quality: Encourages writing tests alongside code, leading to more robust applications.

5. Extensive Standard Library

Go’s standard library is extensive and well-documented:

  • Rich Functionality: Provides numerous built-in functions and packages for various tasks.

  • Ease of Use: Reduces the need for third-party libraries, simplifying project dependencies.

6. Cross-Platform Compatibility

Go is cross-platform, meaning it can compile code for multiple operating systems:

  • Versatility: Allows developers to write code once and run it anywhere.

  • Broad Adoption: Makes Go a good choice for projects targeting multiple environments.

Resources for Learning Go

Starting with Go is straightforward thanks to abundant learning resources. Here are some recommended resources for beginners:

1. Official Go Documentation

The official Go documentation is comprehensive and beginner-friendly:

  • Go Tour: An interactive tour that introduces Go’s syntax and features.

  • Effective Go: A guide to writing clear, idiomatic Go code.

2. Online Courses

Several platforms offer online courses tailored to learning Go:

  • Udemy: Courses like “Learn How To Code: Google’s Go Programming Language”.

  • Coursera: Specializations such as “Programming with Google Go”

3. Books

Books provide in-depth knowledge and structured learning:

  • “The Go Programming Language” by Alan A. A. Donovan and Brian W. Kernighan: A thorough introduction to Go.

  • “Go in Action” by William Kennedy, Brian Ketelsen, and Erik St. Martin: Practical examples and exercises.

4. Community Resources

The Go community is active and supportive:

  • Go Forum: A place to ask questions and share knowledge.

  • Go User Groups (GUGs): Local meetups and events for networking and learning.

Understanding Go as a beginner opens up opportunities to create efficient and reliable applications.

With its simple syntax, fast compilation, strong performance, and rich standard library, Go is an excellent choice for new programmers.

Leverage the available resources, such as official documentation, online courses, books, and community support, to master Go and start building powerful programs today.

Setting Up the Development Environment for Go

Creating a ‘Hello World’ program in Go starts with setting up the development environment.

This section guides you through installing Go on different operating systems, configuring environment variables, and testing the installation.

Installing Go on Different Operating Systems

Go can be installed on various operating systems.

Follow these steps for your specific OS.

#1. Installing Go on Windows

  1. Download Go Installer: Visit the official Go website and download the Windows installer.

  2. Run Installer: Double-click the downloaded file and follow the installation prompts.

  3. Verify Installation: Open Command Prompt and type go version. You should see the installed Go version.

#2. Installing Go on macOS

  1. Download Go Package: Go to the official Go website and download the macOS package.

  2. Install Package: Open the downloaded file and follow the installation instructions.

  3. Verify Installation: Open Terminal and type go version. The installed Go version should be displayed.

#3. Installing Go on Linux

  1. Download Tarball: Visit the official Go website and download the Linux tarball.

  2. Extract Tarball: Use the terminal to extract the tarball: tar -C /usr/local -xzf go1.xx.linux-amd64.tar.gz.

  3. Add Go to Path: Add the Go binary to your PATH in your .profile or .bashrc file.

  4. Verify Installation: Open Terminal and type go version. You should see the installed Go version.

Configuring Go Environment Variables

Configuring environment variables is crucial for Go development.

These variables ensure Go operates correctly.

Setting GOPATH

The GOPATH environment variable specifies the location of your workspace.

Set it up as follows:

  1. Windows:

    • Open System Properties and go to Environment Variables.

    • Create a new user variable GOPATH with the path to your Go workspace.

  2. macOS/Linux:

    • Open your terminal and edit your shell profile file (.bash_profile, .zshrc, etc.).

    • Add export GOPATH=$HOME/go.

    • Add export PATH=$PATH:$GOPATH/bin.

Setting GOROOT

The GOROOT environment variable points to the Go installation directory.

Generally, this is set automatically during installation, but you can set it manually if needed.

  1. Windows:

    • Open System Properties and go to Environment Variables.

    • Create a new user variable GOROOT with the path to your Go installation directory.

  2. macOS/Linux:

    • Open your terminal and edit your shell profile file.

    • Add export GOROOT=/usr/local/go.

Testing the Go Installation

After installing and configuring Go, testing the installation ensures everything works correctly.

  1. Create a Go Workspace: Open your terminal or command prompt and create a directory for your Go workspace, mkdir $HOME/go.

  2. Create a Test Directory: Inside your workspace, create a directory for your test project, mkdir -p $HOME/go/src/helloworld.

  3. Write a Test Program: Inside the helloworld directory, create a file named main.go and add the following code:
package main

import "fmt"

func main() {
    fmt.Println("Hello, World!")
  1. Run the Program: Navigate to the helloworld directory in your terminal and run go run main.go. You should see “Hello, World!” printed on the screen.

Setting up the development environment for Go involves installing the language, configuring environment variables, and testing your setup.

Following these steps ensures you are ready to start programming in Go, beginning with the classic ‘Hello World’ program.

This foundation enables you to explore Go’s powerful features and build more complex applications.

Creating a New Project in Go: A Beginner’s Guide

Overview of Go Project Structure

Understanding Go’s project structure is crucial for efficient coding.

Go projects are organized to simplify development and collaboration.

Typically, a Go project includes:

  • src: Contains source files for the project.

  • pkg: Holds compiled package objects.

  • bin: Stores compiled binaries.

This structure ensures your code is organized and easily accessible.

Setting Up a New Go Project

Setting up a new Go project involves creating directories and files that follow Go’s conventions.

Here’s a step-by-step guide:

  1. Install Go: Ensure Go is installed on your system. Download it from the official Go website.

  2. Create Project Directory: Open your terminal and create a new directory for your project.
   mkdir hello-world
   cd hello-world
  1. Set Go Workspace: Set the GOPATH environment variable to your workspace.
   export GOPATH=$HOME/go
   export PATH=$PATH:$GOPATH/bin
  1. Create Source Directory: Inside your project directory, create a src folder.
   mkdir src
   cd src

Initializing a Go Module

Go modules manage dependencies and versioning. Initializing a Go module is straightforward:

  1. Initialize Module: Run the go mod init command in your project directory.
   go mod init hello-world

This command creates a go.mod file, which tracks your project’s dependencies.

  1. Create Main File: Inside the src directory, create a new file named main.go.
   touch main.go
  1. Write Hello World Program: Open main.go in your preferred text editor and add the following code:
   package main

   import "fmt"

   func main() {
       fmt.Println("Hello, World!")

This simple program prints “Hello, World!” to the console.

  1. Build and Run: Build and run your program to see the output.
   go run main.go

If everything is set up correctly, you should see “Hello, World!” printed on your terminal.

Benefits of Go Modules

Using Go modules offers several benefits:

  • Dependency Management: Go modules automatically manage dependencies, ensuring your project builds with the correct versions.

  • Version Control: Specify versions for dependencies, preventing unexpected changes from breaking your code.

  • Portability: Modules make your projects easily shareable and reproducible across different environments.

Common Go Commands

Familiarize yourself with these common Go commands to streamline your workflow:

  • go build: Compiles the packages.

  • go test: Runs tests.

  • go fmt: Formats the code.

  • go vet: Examines code for potential issues.

  • go run: Compiles and runs the Go program.

  • go get: Downloads and installs packages.

Creating a new Go project is a straightforward process.

Understanding the project structure and using Go modules simplifies dependency management and ensures your code remains organized.

By following these steps, you can set up a new Go project and write your first “Hello, World!” program efficiently.

Embrace these practices to build robust and maintainable Go applications.

Read: Go Language: Concurrency Coding Examples Explained

Writing the “Hello World” Program

Creating a “Hello World” program in Go is a perfect starting point for beginners.

It introduces the syntax and basic structure of Go programs.

This guide will walk you through writing and understanding your first Go program.

Introduction to the Go Syntax

Go, often referred to as Golang, is a statically typed, compiled language designed for simplicity and efficiency.

Its syntax is clean and easy to read, making it a great language for beginners and experienced developers alike.

Basic Structure of a Go Program

A Go program consists of several key components:

  • Package Declaration: Every Go program starts with a package declaration.

  • Import Statements: Import libraries needed for your program.

  • Main Function: The entry point of the program.

Let’s break down these components.

Package Declaration

The package declaration is the first line in a Go program.

It specifies the package name. For executable programs, this is always main.

package main

Import Statements

Next, you import the necessary libraries.

For a “Hello World” program, you need the fmt package, which provides I/O functions.

import "fmt"

Main Function

The main function is the entry point of the program.

The Go runtime calls this function to start the execution of the program.

func main() {
    // Code goes here

Writing the “Hello World” Code

Now, let’s write the complete code for a simple “Hello World” program.

package main

import "fmt"

func main() {
    fmt.Println("Hello, World!")

Explanation of the Code

  1. Package Declaration: Defines the package name. For a standalone executable, use main.
   package main
  1. Import Statement: Imports the fmt package for formatted I/O operations.
   import "fmt"
  1. Main Function: Defines the main function, which is the program’s entry point.
   func main() {
  1. Println Function: Calls fmt.Println to print the string “Hello, World!” to the console.
       fmt.Println("Hello, World!")
  1. Closing the Function: Ends the main function.

Running the Program

To run your “Hello World” program, follow these steps:

  1. Save the File: Save your program in a file named hello.go.

  2. Open Terminal: Navigate to the directory containing hello.go.

  3. Compile and Run: Use the Go compiler to run the program.
   go run hello.go

Expected Output

When you run the program, you should see the following output in your terminal:

Hello, World!

Understanding the Go Syntax

By writing a simple “Hello World” program, you’ve learned the fundamental syntax and structure of a Go program.

The package declaration, import statements, and the main function form the basic framework of any Go application.

The fmt package and its Println function demonstrate how to perform basic input/output operations in Go.

Creating a “Hello World” program is an excellent way to begin learning Go.

This program introduces you to Go’s syntax, the basic structure of a Go program, and how to use essential packages.

By understanding these fundamentals, you can confidently move on to more complex Go programming tasks. Happy coding!

Read: Go Language: When Simplicity and Efficiency Matter

Create a 'Hello World' Program in Go: A Beginner’s Guide

Compiling and Running the Program

Creating a ‘Hello World’ program in Go is an essential first step for beginners.

This guide will walk you through compiling, building, and running the program, ensuring you understand each part of the process.

Building the Go Program

First, you need to write your Go code.

Open your text editor or IDE and type the following:

package main

import "fmt"

func main() {
    fmt.Println("Hello, World!")

Save this file as hello.go. Now, you need to build the program.

  1. Open Terminal or Command Prompt: Navigate to the directory where you saved hello.go.

  2. Build the Program: Run the following command to compile your code:
go build hello.go

This command tells Go to compile hello.go into an executable file.

Executing the Compiled Program

Once the build process completes, you’ll have an executable file named hello (or hello.exe on Windows).

This file is your compiled Go program.

  1. Locate the Executable: Ensure you are in the same directory where the hello executable was created.

  2. Run the Program: Execute the program by typing the following command in your terminal:

For Windows users, type:


Verifying the Output

After running the executable, you should see the output in your terminal.

This output verifies that your Go program has been compiled and executed correctly.

  1. Check the Output: Look at your terminal window. You should see:
Hello, World!

If you see this message, congratulations! You have successfully compiled and run your first Go program.

Troubleshooting Common Issues

Sometimes, you might encounter issues while compiling or running your Go program.

Here are a few common problems and solutions:

  1. File Not Found: Ensure you are in the correct directory where hello.go is saved.

  2. Go Not Installed: Verify that Go is installed by running go version in your terminal. If not installed, download and install Go from the official site.

  3. Permission Denied: On Unix-like systems, you might need to change file permissions. Use chmod +x hello to make the file executable.

Building and Running the Program in One Step

Go also allows you to compile and run your program in a single step. Instead of running go build, you can use:

go run hello.go

This command compiles and runs the program without creating a separate executable file.

It’s useful for quick tests and small programs.

Understanding the Workflow

Compiling and running a Go program involves a few key steps:

  • Writing the Code: Create and save your Go source code file.

  • Building the Program: Use go build to compile the source code into an executable.

  • Running the Executable: Execute the compiled file to see the output.

This workflow is straightforward and essential for all Go projects.

Mastering it lays a solid foundation for more advanced programming in Go.

Compiling and running a Go program is a simple yet crucial process for beginners.

By following this guide, you should be able to build and execute your ‘Hello World’ program, verify the output, and troubleshoot common issues.

This fundamental knowledge will help you as you advance in Go programming, providing a strong base for more complex projects.

Keep practicing, and soon you’ll be building more sophisticated applications in Go.

Read: Coding Blocks in Go: Writing More Efficient Code


Creating a “Hello World” program in Go is an excellent first step in learning this powerful programming language.

Let’s recap the process and encourage further exploration and practice.

Recap of the Entire Process

You started by setting up your Go development environment.

This involved installing Go and configuring your workspace.

Then, you created your first Go file, named hello.go, and wrote a simple program to print “Hello, World!” to the console.

Here’s a quick summary of the steps:

  1. Install Go: Download and install Go from the official website.

  2. Set Up Workspace: Configure your environment variables and create a workspace directory.

  3. Write the Code: Open your text editor and write the main function to print “Hello, World!”.

  4. Run the Program: Use the go run command to execute your program and see the output.

Encouragement to Continue Exploring Go

Now that you’ve created your first Go program, keep exploring the language.

Go is known for its simplicity and efficiency, making it ideal for various applications, from web development to cloud services.

Practice Coding

Practice is crucial in programming.

Write more programs, experiment with different Go features, and solve coding challenges.

Try to build small projects that interest you.

This hands-on approach will deepen your understanding and improve your skills.

Final Thoughts and Resources for Further Learning

Learning Go opens up many opportunities in the tech industry.

Go’s efficiency and performance are highly valued in many sectors.

To further your learning, here are some recommended resources:

  • Official Go Documentation: Comprehensive and well-organized, perfect for reference.

  • Go by Example: Provides clear, concise examples of Go in action.

  • The Go Programming Language by Alan A. A. Donovan and Brian W. Kernighan: A highly recommended book for in-depth learning.

  • Online Tutorials and Courses: Websites like Udemy, Coursera, and Pluralsight offer excellent courses on Go.

Keep exploring, practicing, and building. The journey of learning Go is both rewarding and exciting.

By continuously expanding your knowledge and skills, you’ll become proficient in this versatile language and ready to tackle more complex projects.

Happy coding!

Leave a Reply

Your email address will not be published. Required fields are marked *