Go go.modのモジュール名がGitHubのリポジトリと一致しないものをimportしようとするとどうなるのか

importできません。

目次

呼び出される側のモジュールを作る

• GitHubでgo-helloworldというリポジトリを作る。
• このリポジトリをcloneしてgo mod init helloworldを実行するとgo.modが生成される。

module helloworld

go 1.21.4

• helloworld.goを作成する。

package helloworld

import "fmt"

func HelloWorld() {
    fmt.Println("Hello World!")
}

呼び出す側を作る

• go-sampleというフォルダを作成してgo mod init sampleを実行する。
• main.goを作成する。ここでさっきのgo-helloworldをインポートする。

package main

import "github.com/takurooo/go-helloworld"

func main() {
    helloworld.HelloWorld()
}

• go mod tidyを実行するとgithub.com/takurooo/go-helloworldをdownloadするがmoduleの宣言がgithub.com/takurooo/go-helloworldになっていないと表示される。

go: finding module for package github.com/takurooo/go-helloworld
go: downloading github.com/takurooo/go-helloworld v0.0.0-20240104074603-37cc24b9797d
go: found github.com/takurooo/go-helloworld in github.com/takurooo/go-helloworld v0.0.0-20240104074603-37cc24b9797d
go: sample imports
    github.com/takurooo/go-helloworld: github.com/takurooo/go-helloworld@v0.0.0-20240104074603-37cc24b9797d: parsing go.mod:
    module declares its path as: helloworld
            but was required as: github.com/takurooo/go-helloworld

• go run main.goを実行してもmoduleがなくてエラーになる。

main.go:3:8: no required module provides package github.com/takurooo/go-helloworld; to add it:
    go get github.com/takurooo/go-helloworld

まとめ

• go mod tidy実行時にGitHubからgithub.com/takurooo/go-helloworldのリポジトリをダウンロードしている。
• ダウンロード後にgo.modのmodule名がリポジトリ名と一致しているかをチェックしているみたい。
• ここで不一致が起これば、go.modに依存関係を追加してくれない。(= インポートできない)