Installing Go and Setting Up Environment

# CHAPTER 2

Installing Go and Setting Up Environment #

1. Introduction #

2. Learning Objectives #

• Download and install Go on Windows, macOS, or Linux.

• Verify the installation using the terminal.

• Understand the historical concepts of GOROOT and GOPATH.

• Install and configure Visual Studio Code (VS Code) for Go development.

3. Downloading and Installing Go #

Step 1: Download the Installer

1. 1. Navigate to the official website: https://go.dev/dl/

1. 2. Download the installer matching your Operating System (Windows .msi, macOS .pkg, or Linux .tar.gz).

#### Installing on Windows

1. 1. Double-click the downloaded .msi file.

1. 2. Follow the prompts and accept the default installation path (usually C:\Program Files\Go).

1. 3. The installer automatically adds Go to your system's PATH environment variable.

#### Installing on macOS

1. 1. Double-click the .pkg file and follow the installation wizard.

1. 2. Alternatively, if you use Homebrew, simply open your terminal and run:

   brew install go
   ```

#### Installing on Linux (Ubuntu/Debian)
1. Remove any old Go installations and extract the new archive:
   ```bash
   rm -rf /usr/local/go && tar -C /usr/local -xzf go1.x.x.linux-amd64.tar.gz
   ```
2. Add Go to your PATH by adding this line to your `~/.profile` or `~/.bashrc`:
   ```bash
   export PATH=$PATH:/usr/local/go/bin
   ```
3. Run `source ~/.bashrc` to apply the changes.

### 4. Verifying the Installation
Open your terminal (Command Prompt on Windows, Terminal on Mac/Linux) and type:

bash go version

*Output Example:* `go version go1.21.0 windows/amd64`
If you see this, Go is successfully installed!

### 5. Understanding GOROOT and GOPATH
If you read older Go tutorials (pre-2019), you will see heavy mentions of `GOROOT` and `GOPATH`. 
*   **`GOROOT`:** Where the Go compiler and standard library are installed (e.g., `C:\Program Files\Go`). You rarely need to touch this.
*   **`GOPATH`:** In the old days of Go, *all* your projects had to be strictly placed inside a specific `GOPATH/src` folder. 

**Modern Go (Go Modules):**
Since Go 1.11, Go introduced **Go Modules**. You no longer need to worry about `GOPATH`. You can create your Go projects in any folder on your computer (e.g., your Desktop or Documents folder) just like Python or Node.js!

### 6. Setting Up Visual Studio Code (VS Code)
Writing Go in Notepad is painful. We will use Visual Studio Code, the industry standard for Go development.

1. Download and install VS Code from [code.visualstudio.com](https://code.visualstudio.com/).
2. Open VS Code.
3. Click on the **Extensions** icon on the left sidebar (or press `Ctrl+Shift+X`).
4. Search for **"Go"** (the official extension published by the Go Team at Google) and click **Install**.

#### Installing Go Tools in VS Code
Once the extension is installed, VS Code needs to download helper tools (for formatting, debugging, and autocomplete).
1. Press `Ctrl+Shift+P` (Windows) or `Cmd+Shift+P` (Mac) to open the Command Palette.
2. Type `Go: Install/Update Tools` and press Enter.
3. Check the box at the top to select all tools, then click **OK**.
4. Wait for the terminal to finish installing the tools.

### 7. Creating Your Workspace
Let's prepare a folder for all the code we will write in this course.
1. Create a folder named `golang-course` anywhere on your computer.
2. Open VS Code.
3. Go to `File > Open Folder` and select `golang-course`.

To initialize this folder as a modern Go project, open the VS Code integrated terminal (`Ctrl + ~`) and run:

bash go mod init golang-course `` This creates a go.mod file, which manages any third-party dependencies (similar to package.json in Node.js).

• "go is not recognized as an internal or external command" on Windows: This means the Go installer failed to add Go to your System PATH. You will need to manually add C:\Program Files\Go\bin to your Environment Variables.

• Writing code outside a Module: Always run go mod init <project-name> when starting a new project folder. Without it, VS Code might show false errors.

• Use gofmt: Ensure your VS Code is set to "Format on Save" so it automatically runs gofmt every time you save a file.

1. 1. Install Go and verify it by running go version in your terminal.

1. 3. Create a folder named my-first-go, open it in VS Code, and run go mod init my-first-go in the terminal.

Debugging Task: If a junior developer cannot run their Go code because of a "missing go.mod" error, how would you instruct them to fix it? (Answer: Open terminal in project root and run go mod init [project_name]).

15. Next Chapter Recommendation #