Використання Go (Golang)

Огляд

Go (часто званий Golang) — це статично типізована, компільована мова програмування з відкритим кодом, яку розробила компанія Google. Вона полюбилася розробникам завдяки лаконічному синтаксису, надзвичайно швидкій компіляції, потужній підтримці багатопоточності (через легкі goroutine та механізм комунікації channel) і ефективному вбудованому збору сміття. Go чудово підходить для створення високопродуктивних мережевих сервісів, розподілених систем, мікросервісів і CLI-інструментів. Це один із основних виборів у сучасній cloud-native та бекенд-розробці.

Підтримка Go у ServBay

ServBay — це інтегроване локальне середовище для веб-розробки, створене спеціально для macOS, яке надає безшовну та потужну підтримку розробникам на Go. З ServBay можна дуже легко встановлювати, керувати та перемикатися між різними версіями Go без потреби вручну налаштовувати складні змінні середовища (наприклад, GOROOT, GOPATH), що значно спрощує ініціалізацію та обслуговування середовища розробки Go.

ServBay має повний комплект інструментів Go і підтримує широкий діапазон версій — від історичних до останніх стабільних, щоб ви могли задовольнити вимоги різних проектів:

Go 1.11
Go 1.12
Go 1.13
Go 1.14
Go 1.15
Go 1.16
Go 1.17
Go 1.18
Go 1.19
Go 1.20
Go 1.21
Go 1.22
Go 1.23
Go 1.24 (а також новіші версії, які можуть додаватися у подальших оновленнях ServBay)

Підтримка Go Modules

Середовище ServBay за замовчуванням використовує і рекомендує Go Modules для керування залежностями. Починаючи з Go 1.11, це стандартне рішення від команди Go. У терміналі ServBay можна просто використовувати команди go mod (такі як go mod init, go get, go mod tidy) для керування залежностями проекту й не перейматися про налаштування традиційного $GOPATH.

Передумови

У вас успішно встановлено та запущено ServBay на macOS.
Ви маєте базові знання програмування на Go.
Ви орієнтуєтеся у базових командах Terminal.

Встановлення Go

Встановити Go через інтуїтивну графічну панель ServBay дуже просто:

Запустіть додаток ServBay.
В лівій панелі навігації натисніть “Пакети”.
У списку пакетів знайдіть категорію “Go”.
Клікніть по “Go” для розгортання списку підтримуваних версій.
Виберіть необхідну версію Go (зазвичай рекомендовано найновішу стабільну, наприклад, Go 1.24). Натисніть “Встановити” поряд із потрібною версією.
ServBay автоматично завантажить та встановить вибрану версію Go. Час встановлення залежить від швидкості вашого інтернет-з’єднання.

Після завершення встановлення ви побачите статус “встановлено” — можна додавати чи перемикатися між іншими версіями за потреби.

Використання Go

Після встановлення Go ви можете використовувати набір команд go безпосередньо у Terminal.

Щоб перевірити, чи успішно інстальовано Go та яка версія активна, виконайте:

bash

go version

Термінал виведе щось подібне, де буде зазначено версію Go, якою керує ServBay:

go version go1.24.1 darwin/arm64

Створення та запуск простого Go Web додатка

Далі створимо базовий приклад HTTP-серверу на Go та скомпілюємо й запустимо його через ServBay.

Створіть директорію проекту: Рекомендується розміщувати Go-проекти у каталозі за замовчуванням /Applications/ServBay/www. Давайте створимо папку go-servbay-demo.
bash
```
cd /Applications/ServBay/www
mkdir go-servbay-demo
cd go-servbay-demo
```
1
2
3
Ініціалізуйте Go Modules: У корені проекту (go-servbay-demo) виконайте команду go mod init. Рекомендується використовувати унікальний ідентифікатор, пов'язаний із репозиторієм або проектом (для прикладу — просто ім'я директорії).
bash
```
go mod init go-servbay-demo
```
1
У поточній папці з’явиться файл go.mod, який відслідковуватиме залежності проекту.

Напишіть код Go: Створіть файл main.go і вставте таку програму:

package main

import (
	"fmt"
	"log"
	"net/http"
	"os"
)

func handler(w http.ResponseWriter, r *http.Request) {
	hostname, _ := os.Hostname()
	fmt.Fprintf(w, "Hello from Go on ServBay!\nHostname: %s\nPath: %s\n", hostname, r.URL.Path)
}

func main() {
	http.HandleFunc("/", handler)

	port := "8080" // Визначення порту, на якому слухає сервер
	log.Printf("Go web server starting on port %s...", port)
	log.Printf("Access it at http://localhost:%s", port)

	// Запуск HTTP-сервера
	err := http.ListenAndServe(":"+port, nil)
	if err != nil {
		log.Fatalf("Error starting server: %s\n", err)
	}
}

Цей код створює простий HTTP-сервер, що слухає порт 8080. Для будь-яких запитів він відповідатиме текстом з “Hello from Go on ServBay!”, іменем хоста та шляхом запиту.

Запуск додатка Go: Переконайтеся, що ви у проектній директорії (/Applications/ServBay/www/go-servbay-demo) в терміналі ServBay. Запустіть програму командою:
bash
```
go run main.go
```
1
Якщо все пройшло успішно, у терминалі побачите повідомлення, що сервер запущений:
```
2024/05/20 15:00:00 Go web server starting on port 8080...
2024/05/20 15:00:00 Access it at http://localhost:8080
```
1
2
Перевірка веб-додатка: Відкрийте браузер і перейдіть за адресою http://localhost:8080. Ви повинні побачити відповідь на зразок “Hello from Go on ServBay! Hostname: ваш-mac-hostname Path: /”.

Використання зворотного проксі ServBay для сайту (рекомендується)

Попри можливість доступу через localhost:8080, в локальній розробці зручніше користуватися зрозумілим доменом (наприклад, go-app.servbay.demo) і проксирувати запити через веб-сервер ServBay (Caddy, Apache, Nginx). Це дозволить вам працювати через стандартні HTTP/HTTPS-порти і користуватися перевагами ServBay (автоматичний HTTPS, інтеграція з іншими сервісами).

Створіть сайт у ServBay:
- Відкрийте GUI ServBay і перейдіть до розділу “Сайти”.
- Натисніть “Додати сайт”.
- Домен: впишіть бажане локальне ім’я, наприклад, go-app.servbay.demo.
- Тип сайту: оберіть Зворотний проксі (Reverse Proxy).
- IP-адреса: введіть 127.0.0.1.
- Порт: введіть 8080.

Збережіть і перезапустіть сервер: Збережіть зміни у GUI та переконайтеся, що перезапустили відповідний веб-сервер (Caddy чи Nginx), щоб активувати нову конфігурацію.
Доступ до додатка через домен: Тепер у браузері заходьте на https://go-app.servbay.demo — веб-сервер ServBay прийме та прозоро передасть запити вашій Go-програмі.

Керування версіями Go

ServBay значно спрощує керування та перемикання між різними версіями Go.

Зміна версії: У GUI ServBay у розділі “Пакети” → “Go” будуть показані всі встановлені версії. У меню “Налаштування” ліворуч можна вибрати версію Go за замовчуванням.
Перевірка: Після перемикання відкрийте новий термінал і виконайте go version, щоб впевнитися, що нова версія активна.

Проектний контроль версії Go через `.servbay.config`

Окрім глобального перемикання версій, ServBay пропонує більш гнучке — проектне керування версіями за допомогою файла .servbay.config у корені проекту.

Як це працює:

Коли ви у терміналі ServBay переходите (cd) у директорію, де є .servbay.config, програма автоматично зчитує цей файл та, згідно з налаштуваннями (наприклад, GO_VERSION), тимчасово змінює середовище так, щоб команда go використовувала обрану версію.

Формат конфігурації:

.servbay.config — це простий текстовий файл з парами "ключ-значення". Щоб вказати версію Go для проекту, додайте рядок GO_VERSION:

ini

# Приклад .servbay.config
# Вказати для проекту використання Go 1.22
GO_VERSION=1.22

# Можна також вказати версії інших інструментів
# PHP_VERSION=8.3
# NODE_VERSION=20
# PYTHON_VERSION=3.11
# ... інші можливі конфігурації ...
# GOPROXY=https://goproxy.cn,direct

Переваги:

Автоматичне перемикання версій: Не треба вручну змінювати версію для всієї системи — достатньо зайти у папку проекту.
Ізоляція проектів: Кожен проект гарантовано працює у потрібному середовищі, без конфліктів.
Командна робота: Якщо файл .servbay.config збережений у git-репозиторії, вся команда автоматично використовує потрібні настройки після клонування.

Використання на практиці:

Припустимо, ви маєте два проекти:

project-a потребує Go 1.12
project-b використовує Go 1.22

Створіть у кожній кореневій папці відповідний .servbay.config:

/Applications/ServBay/www/project-a/.servbay.config:
ini
```
GO_VERSION=1.12
```
1
/Applications/ServBay/www/project-b/.servbay.config:
ini
```
GO_VERSION=1.22
```
1

Якщо у терміналі ServBay виконати cd /Applications/ServBay/www/project-a і запустити go version, ви побачите Go 1.12.x. Зайшовши у cd /Applications/ServBay/www/project-b — Go 1.22.x.

Примітка: .servbay.config впливає лише на базову версію Go в середовищі ServBay. Для керування залежностями проекту все одно використовуйте Go Modules (go.mod).

Часті питання (FAQ)

Q: У терміналі ServBay команда go повертає "command not found"?
A: Перевірте, чи коректно налаштована змінна PATH для середовища ServBay. Також переконайтеся, що у GUI ServBay у розділі “Пакети” > “Go” встановлено хоча б одну версію Go, і вона активна.
Q: Як оновити Go до нової версії через ServBay?
A: Регулярно перевіряйте розділ “Пакети” > “Go” у ServBay. Коли стають доступними нові версії, просто натисніть “Встановити”, а потім оберіть нову версію як активну через GUI.
Q: Go Modules завантажує залежності дуже повільно або виникають проблеми з мережею?
A: Go Modules за замовчуванням використовує proxy.golang.org. Якщо ви в Китаї чи іншому регіоні з обмеженим доступом до зовнішніх серверів, можна налаштувати змінну середовища GOPROXY для використання швидших дзеркал, наприклад, https://goproxy.cn чи https://goproxy.io. Зробити це можна у глобальних налаштуваннях ServBay або у .servbay.config (наприклад, GOPROXY=https://goproxy.cn,direct).
Q: Мій Go Web-додаток не запускається, пише, що порт уже зайнятий (address already in use)?
A: Це означає, що порт (наприклад, 8080) вже зайнятий іншою програмою. Можна або змінити порт у коді (наприклад, на 8081, 9000), або знайти і завершити той процес, що використовує порт. На macOS скористайтеся командою lsof -i :<номер_порту>, наприклад, lsof -i :8080, щоб дізнатися PID, та kill <PID>, щоб зупинити процес.
Q: Яка різниця між .servbay.config і глобальним перемиканням версії Go? Що краще використовувати?
A: Глобальне перемикання через GUI ServBay змінює версію Go для всієї системи. .servbay.config — це проектне налаштування, що тимчасово змінює версію для певної директорії у сесії терміналу. Рекомендуємо використовувати .servbay.config для кожного проекту окремо — так легко уникнути конфліктів і повторити середовище для всієї команди. Глобальне перемикання підходить для встановлення основної, найчастіше використовуваної, версії.

Підсумок

ServBay надає розробникам Go (Golang) на macOS потужне і просте у використанні локальне середовище. Через інтуїтивний інтерфейс ви можете швидко встановлювати, керувати багатьма версіями Go і використовувати .servbay.config для проектного контролю версій. Завдяки Go Modules для залежностей і можливості проксірування через вбудовані веб-сервери ServBay ви легко розгорнете та протестуєте свої Go-додатки. ServBay максимально спрощує налаштування, дозволяючи зосередитися на написанні й розвитку вашого Go-коду.

Використання Go (Golang) ​

Огляд ​

Підтримка Go у ServBay ​

Передумови ​

Встановлення Go ​

Використання Go ​

Створення та запуск простого Go Web додатка ​

Використання зворотного проксі ServBay для сайту (рекомендується) ​

Керування версіями Go ​

Проектний контроль версії Go через .servbay.config ​

Часті питання (FAQ) ​

Підсумок ​