クイックスタート
Ginクイックスタートガイドへようこそ!このガイドでは、Ginのインストール、プロジェクトの設定、最初のAPIを作成する手順を分かりやすく紹介します。これにより、安心してWebサービスを構築できます。
必要条件
- Go: バージョン1.23以上がインストールされている必要があります。
- Goがあなたの
PATHに含まれ、ターミナルから使用できることを確認してください。インストールに困った場合は公式ドキュメントをご覧ください。
ステップ1: Ginのインストールとプロジェクトの初期化
まず、新しいプロジェクトフォルダを作成し、Goモジュールを初期化します:
mkdir gin-quickstart && cd gin-quickstartgo mod init gin-quickstartGinパッケージを依存関係に追加します:
go get -u github.com/gin-gonic/ginステップ2: Ginアプリの作成
main.goというファイルを作成します:
touch main.gomain.goを開いて、次のコードを追加してください:
package main
import "github.com/gin-gonic/gin"
func main() { router := gin.Default() router.GET("/ping", func(c *gin.Context) { c.JSON(200, gin.H{ "message": "pong", }) }) router.Run() // デフォルトで0.0.0.0:8080で待機します}ステップ3: APIサーバの起動
次のコマンドでサーバを起動します:
go run main.goブラウザでhttp://localhost:8080/pingにアクセスすると、以下が表示されます:
{"message":"pong"}追加例: Ginでnet/httpを使う
レスポンスコードにnet/httpの定数を使いたい場合は、インポートしてください:
package main
import ( "github.com/gin-gonic/gin" "net/http")
func main() { router := gin.Default() router.GET("/ping", func(c *gin.Context) { c.JSON(http.StatusOK, gin.H{ "message": "pong", }) }) router.Run()}ヒント & リソース
-
Goの初心者ですか?Goコードの書き方と実行方法はこちら。
-
もっと詳しいサンプルが必要なら、次のコマンドを使用してください:
Terminal window curl https://raw.githubusercontent.com/gin-gonic/examples/master/basic/main.go > main.go -
詳しいドキュメントはGin公式ドキュメントをご覧ください。