// main.go
package main
import (
	"fmt"
	"os"
	"strconv"
)
func main() {
	// os.Args 至少包含程序名，所以長度至少為 1
	// 我們需要兩個參數(shù)，所以長度至少為 3
	if len(os.Args) < 3 {
		fmt.Println("用法: adder <數(shù)字1> <數(shù)字2>")
		os.Exit(1) // 非零退出碼表示錯誤
	}
	// 獲取參數(shù)
	arg1 := os.Args[1]
	arg2 := os.Args[2]
	// 將字符串轉(zhuǎn)換為整數(shù)
	num1, err := strconv.Atoi(arg1)
	if err != nil {
		fmt.Printf("錯誤: '%s' 不是一個有效的整數(shù)\n", arg1)
		os.Exit(1)
	}
	num2, err := strconv.Atoi(arg2)
	if err != nil {
		fmt.Printf("錯誤: '%s' 不是一個有效的整數(shù)\n", arg2)
		os.Exit(1)
	}
	// 計算并打印結(jié)果
	sum := num1 + num2
	fmt.Printf("結(jié)果: %d + %d = %d\n", num1, num2, sum)
}

# 編譯
go build -o adder main.go
# 運行
./adder 10 25
# 輸出: 結(jié)果: 10 + 25 = 35
# 錯誤情況
./adder 10 abc
# 輸出: 錯誤: 'abc' 不是一個有效的整數(shù)

// main.go
package main
import (
	"flag"
	"fmt"
)
func main() {
	// 定義標(biāo)志
	// flag.String(標(biāo)志名, 默認(rèn)值, 幫助信息)
	// 返回一個字符串指針
	port := flag.Int("port", 8080, "Web 服務(wù)器監(jiān)聽的端口號")
	host := flag.String("host", "localhost", "Web 服務(wù)器綁定的主機名")
	verbose := flag.Bool("v", false, "啟用詳細輸出模式")
	// 定義一個簡短形式的標(biāo)志，例如 -h 可以是 --host 的簡寫
	// flag 包本身不支持直接別名，但可以通過定義兩個變量指向同一個值來實現(xiàn)
	// 這里我們只演示標(biāo)準(zhǔn)用法
	// 解析命令行參數(shù)
	// 必須在所有 flag 定義之后，在訪問它們的值之前調(diào)用
	flag.Parse()
	// 使用標(biāo)志的值（通過解引用指針 *port）
	fmt.Println("--- 配置信息 ---")
	fmt.Printf("主機: %s\n", *host)
	fmt.Printf("端口: %d\n", *port)
	fmt.Printf("詳細模式: %t\n", *verbose)
	// 獲取非標(biāo)志參數(shù)
	// 例如: ./webserver --port=9999 file1.txt file2.txt
	// flag.Args() 將返回 [file1.txt file2.txt]
	args := flag.Args()
	if len(args) > 0 {
		fmt.Println("\n--- 其他文件參數(shù) ---")
		for i, arg := range args {
			fmt.Printf("參數(shù) %d: %s\n", i+1, arg)
		}
	}
	fmt.Println("\n服務(wù)器模擬啟動...")
}

# 編譯
go build -o webserver main.go
# 使用默認(rèn)值運行
./webserver
# 輸出:
# --- 配置信息 ---
# 主機: localhost
# 端口: 8080
# 詳細模式: false
# 服務(wù)器模擬啟動...
# 使用自定義標(biāo)志運行
./webserver --port=9999 --host=0.0.0.0 -v
# 輸出:
# --- 配置信息 ---
# 主機: 0.0.0.0
# 端口: 9999
# 詳細模式: true
# ...
# 混合使用標(biāo)志和位置參數(shù)
./webserver -v config.yaml data.json
# 輸出:
# --- 配置信息 ---
# 主機: localhost
# 端口: 8080
# 詳細模式: true
#
# --- 其他文件參數(shù) ---
# 參數(shù) 1: config.yaml
# 參數(shù) 2: data.json
# ...
# 自動生成幫助信息
./webserver -h
# 或
./webserver --help
# 輸出:
# Usage of ./webserver:
#   -host string
#         Web 服務(wù)器綁定的主機名 (default "localhost")
#   -port int
#         Web 服務(wù)器監(jiān)聽的端口號 (default 8080)
#   -v    啟用詳細輸出模式

# 安裝 Cobra CLI 工具
go install github.com/spf13/cobra-cli@latest
# 在你的項目中添加 Cobra 依賴
go get -u github.com/spf13/cobra@latest

mkdir mygit && cd mygit
go mod init mygit
# 使用 cobra-cli 初始化
cobra-cli init

# 添加 commit 子命令
cobra-cli add commit
# 添加 clone 子命令
cobra-cli add clone

// cmd/root.go
package cmd
import (
	"fmt"
	"os"
	"github.com/spf13/cobra"
)
var cfgFile string // 用于存儲 --config 標(biāo)志的值
// rootCmd represents the base command when called without any subcommands
var rootCmd = &cobra.Command{
	Use:   "mygit",
	Short: "一個模擬 Git 的版本控制工具",
	Long:  `MyGit 是一個用 Go 和 Cobra 庫編寫的命令行應(yīng)用程序，用于演示如何構(gòu)建復(fù)雜的 CLI 工具。它模擬了 Git 的一些基本功能。`,
}
// 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() {
	err := rootCmd.Execute()
	if err != nil {
		os.Exit(1)
	}
}
func init() {
	// 在這里定義全局標(biāo)志和配置。
	// Cobra 支持持久性標(biāo)志，該標(biāo)志對此命令及其每個子命令都可用。
	rootCmd.PersistentFlags().StringVar(&cfgFile, "config", "", "配置文件 (默認(rèn)為 $HOME/.mygit.yaml)")
	// Cobra 也支持本地標(biāo)志，該標(biāo)志僅對直接調(diào)用此命令時可用。
	// rootCmd.Flags().BoolP("toggle", "t", false, "Help message for toggle")
}

// cmd/commit.go
package cmd
import (
	"fmt"
	"github.com/spf13/cobra"
)
var commitMessage string
// commitCmd represents the commit command
var commitCmd = &cobra.Command{
	Use:   "commit",
	Short: "記錄對倉庫的更改",
	Long:  `Commit 命令用于將暫存區(qū)的更改保存到本地倉庫的歷史記錄中。它需要一個提交信息來描述這次更改的內(nèi)容。`,
	Run: func(cmd *cobra.Command, args []string) {
		fmt.Println("執(zhí)行 commit 命令...")
		if commitMessage == "" {
			fmt.Println("錯誤: 必須使用 -m 標(biāo)志提供提交信息。")
			return
		}
		fmt.Printf("提交信息: \"%s\"\n", commitMessage)
		fmt.Println("成功提交更改！")
	},
}
func init() {
	// 將 commit 命令添加到根命令
	rootCmd.AddCommand(commitCmd)
	// 在這里定義 commit 命令的標(biāo)志和配置。
	// StringVarP 是 StringVar 的增強版，支持簡寫形式，例如 -m
	// commitCmd.Flags().StringVarP(&commitMessage, "message", "m", "", "提交信息")
	// 更標(biāo)準(zhǔn)的寫法是直接使用 "m" 作為簡寫
	commitCmd.Flags().StringVarP(&commitMessage, "message", "m", "", "提交信息 (必需)")
	
	// 可以將標(biāo)志標(biāo)記為必需
	commitCmd.MarkFlagRequired("message")
}

// cmd/clone.go
package cmd
import (
	"fmt"
	"github.com/spf13/cobra"
)
// cloneCmd represents the clone command
var cloneCmd = &cobra.Command{
	Use:   "clone [url]",
	Short: "將一個倉庫克隆到新目錄中",
	Long:  `Clone 命令用于從遠程 URL 下載一個倉庫，并創(chuàng)建一個本地副本。`,
	Args: cobra.ExactArgs(1), // 驗證必須有且僅有 1 個參數(shù)
	Run: func(cmd *cobra.Command, args []string) {
		fmt.Println("執(zhí)行 clone 命令...")
		repoURL := args[0]
		fmt.Printf("正在從 '%s' 克隆倉庫...\n", repoURL)
		fmt.Println("克隆完成！")
	},
}
func init() {
	rootCmd.AddCommand(cloneCmd)
}

// main.go
package main
import "mygit/cmd"
func main() {
	cmd.Execute()
}

# 編譯整個項目
go build -o mygit .
# 查看根命令幫助
./mygit -h
# 輸出非常詳細和美觀的幫助信息
# 查看子命令幫助
./mygit commit -h
./mygit clone -h
# 運行 commit 命令
./mygit commit -m "Initial commit"
# 輸出:
# 執(zhí)行 commit 命令...
# 提交信息: "Initial commit"
# 成功提交更改！
# 測試必需標(biāo)志
./mygit commit
# 輸出:
# Error: required flag(s) "message" not set
# Usage:...
# (會顯示幫助信息)
# 運行 clone 命令
./mygit clone https://github.com/user/repo.git
# 輸出:
# 執(zhí)行 clone 命令...
# 正在從 'https://github.com/user/repo.git' 克隆倉庫...
# 克隆完成！
# 測試參數(shù)驗證
./mygit clone
# 輸出:
# Error: accepts 1 arg(s), received 0
# Usage:...