Cobraを利用したアプリ開発でgo installしてもエイリアスが作成されない

Question

概要

Go言語を勉強中の者です。
ストップウォッチ機能を作成しています。
CLIで動作するため、Cobraを利用して開発しています。
利用性向上のために、開発者側で設定したコマンド名のエイリアスを作成したいのですが、
実装方法がわからず停滞しています。

Cobraを利用している記事等を見ると、go installでエイリアスが作成されるようですが、
Command not foundとなってしまいます。

実現したいこと

• go run main.go stopwatchではなく、go-timer stopwatchで動作するようにする。

発生している問題・エラーメッセージ

go-timer: command not found

該当のソースコード

/*
Copyright © 2022 NAME HERE <EMAIL ADDRESS>

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/
package cmd

import (
	"fmt"
	"os"

	"github.com/spf13/cobra"

	homedir "github.com/mitchellh/go-homedir"
	"github.com/spf13/viper"
)

var cfgFile string

// rootCmd represents the base command when called without any subcommands
var rootCmd = &cobra.Command{
	Use:   "goTimer",
	Short: "ストップウォッチの機能を提供しています。",
	Long: `ストップウォッチの機能を提供しています。

	go-timer stopwatch で利用可能です。
	終了時はCtrl+Cを入力してください。`,
	// Uncomment the following line if your bare application
	// has an action associated with it:
	//	Run: func(cmd *cobra.Command, args []string) { },
}

// Execute adds all child commands to the root command and sets flags appropriately.
// This is called by main.main(). It only needs to happen once to the rootCmd.
func Execute() {
	if err := rootCmd.Execute(); err != nil {
		fmt.Println(err)
		os.Exit(1)
	}
}

func init() {
	cobra.OnInitialize(initConfig)

	// Here you will define your flags and configuration settings.
	// Cobra supports persistent flags, which, if defined here,
	// will be global for your application.

	rootCmd.PersistentFlags().StringVar(&cfgFile, "config", "", "config file (default is $HOME/.go-timer.yaml)")

	// Cobra also supports local flags, which will only run
	// when this action is called directly.
	rootCmd.Flags().BoolP("toggle", "t", false, "Help message for toggle")
}

// initConfig reads in config file and ENV variables if set.
func initConfig() {
	if cfgFile != "" {
		// Use config file from the flag.
		viper.SetConfigFile(cfgFile)
	} else {
		// Find home directory.
		home, err := homedir.Dir()
		if err != nil {
			fmt.Println(err)
			os.Exit(1)
		}

		// Search config in home directory with name ".go-timer" (without extension).
		viper.AddConfigPath(home)
		viper.SetConfigName(".go-timer")
	}

	viper.AutomaticEnv() // read in environment variables that match

	// If a config file is found, read it in.
	if err := viper.ReadInConfig(); err == nil {
		fmt.Println("Using config file:", viper.ConfigFileUsed())
	}
}

試したこと

go-timer$ go build
go-timer$ go install

補足情報（FW/ツールのバージョンなど）

requirements
ubuntu20.04.01 LTS
go1.17.8 linux/amd64
github.com/spf13/cobra v1.3.0

ソースコード
Cobraのソースコード
私のソースコード

Comments

[hoshi-takanori]

go build や go install で生成されるのはエイリアスではなく実行形式 (実行ファイル) です。go run だと毎回コンパイルしてから動かすことになり無駄なので、プログラムが完成したらビルドして実行形式を動かすのが一般的です。
go build すれば go-timer という名前の実行形式がプロジェクトフォルダに作られるので、./go-timer stopwatch で動きます。そして、go install すれば $GOBIN または $GOPATH/bin または $HOME/go/bin に作られるので、そこにパスを通せば go-timer stopwatch で動くと思います。
https://blog.applibot.co.jp/2021/04/20/go-install/
あと、Ctrl+C は通常プログラムを強制終了するために使われるので、ストップウォッチの計測終了という正常な処理を Ctrl+C に割り当てるのはちょっとどうかと…。
この辺は Go 以前に普通の Linux の使い方の話なので、その辺をおさらいすることをお勧めします。

[Riku-smile]

ご指摘ありがとうございます。
本題の件はhoshi-takanori様のご指摘をもとに見直したところ、無事解決に至りました。

また、ストップウォッチの終了処理についても、今後勘案して開発してみたいと思います。
ありがとうございました。

Answer 1

解決しました

hoshi-takanori様の助言に基づいて、以下を確認いたしました。

1. ~/go-timerに.go-timerの実行ファイルが作成されていることを確認
2. go install後に$GOPATH/binを確認し、.go-timerの実行ファイルが作成されていることを確認
3. go env GOPATHでGOPATHの確認

まず、1を確認したところ、問題なく~/go-timerに.go-timerの実行ファイルが作成されておりました。

次に、2を確認したところ、エクスプローラー上では$GOPATH/bin下に.go-timerが作成されておりました。
一方、Shell上にてls $GOPATH/bin | grep .go-timerを実行したところ、.go-timerファイルは検出されませんでした。

そこで、$GOPATH関係に問題があると目星をつけ、Psychedelic Engineer Note様の記事を参考にGOPATHを設定しなおしました。

その結果、Shellを再度立ち上げて

~/go-timer$ go install
~$ ls $GOPATH/bin | grep .go-timer

を実行すると、無事.go-timerが検出され、本質問の課題を解決することができました。

助言をくださったhoshi-takanori様に深く感謝申し上げます。

---

P.S.
go env GOPATHを確認したところ、~/.bashrcを操作する前後で出力自体は変更がありませんでした。
よって、おそらく以前.bashrcを操作した際に不必要と判断したなんらかの設定が抜けていたことが原因だと考えられます。
一つずつ挙動を確認していったわけではないため、具体的な原因はわかりかねます。ご了承ください。