Paramètres du package Golang

Golang est un langage de programmation efficace, concis et sûr, populaire pour ses excellentes performances de concurrence, sa syntaxe simple et sa lisibilité. Dans Golang, un package est l'unité de base pour organiser le code, et chaque package peut contenir plusieurs fichiers.

Cet article expliquera comment configurer un package Golang, y compris des concepts importants tels que le nom du package, le chemin d'importation, la visibilité, le contrôle de version et les commentaires sur la documentation.

1. Nom du package

Dans Golang, chaque fichier doit appartenir à un package. Un package Golang se compose d'un ou plusieurs fichiers avec le suffixe .go. Les noms de packages doivent être uniques et cohérents avec leurs noms de répertoire.

Exemple :

Supposons que nous écrivions le code suivant dans un répertoire appelé hello :

package main

import "fmt"

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

Ouvrez un terminal dans le répertoire et exécutez la commande suivante :

go run .

Hello, World sera affiché. Dans cet exemple, nous avons utilisé le nom du package main car le nom du répertoire du package est hello et le package n'appartient à aucun autre package.

2. Chemin d'importation

Dans Golang, utilisez le mot-clé import pour importer un ou plusieurs packages. Le chemin d'importation peut être un chemin relatif ou un chemin absolu.

Chemin relatif :

Supposons que nous écrivions le code suivant dans le répertoire src/hello :

package main

import "./utils"

func main() {
    utils.PrintMessage("Hello")
}

Ouvrez un terminal dans le répertoire et exécutez la commande suivante :

go run .

Hello sera affiché. Dans cet exemple, nous utilisons un chemin relatif pour importer le package nommé utils.

Chemin absolu :

Supposons que nous écrivions le code suivant dans le répertoire $GOPATH/src/example.com/hello :

package main

import "example.com/utils"

func main() {
    utils.PrintMessage("Hello")
}

Ouvrez un terminal dans le répertoire et exécutez la commande suivante :

go run .

Bonjour sera affiché. Dans cet exemple, nous avons importé le package nommé utils en utilisant un chemin absolu. Notez que example.com est un nom de domaine virtuel, qui sera mappé au répertoire $GOPATH/src/example.com.

3. Visibilité

Dans Golang, les identifiants tels que les variables, les constantes, les fonctions et les structures ont une visibilité différente. La visibilité d'un identifiant dépend du package dans lequel il existe.

Dans un package, les identifiants peuvent être publics ou privés. Un identifiant n'est visible qu'au sein du package dans lequel il apparaît.

Tous les identifiants commençant par des lettres majuscules sont publics, ils peuvent être utilisés par d'autres packages ; tous les identifiants commençant par des lettres minuscules sont privés, ils ne peuvent être utilisés que dans le package dans lequel ils se trouvent.

Par exemple, un package nommé utils peut contenir le code suivant :

package utils

import "fmt"

const Pi = 3.14159

func add(x int, y int) int {
    return x + y
}

func PrintMessage(message string) {
    fmt.Println(message)
}

Lors de l'utilisation de ce package dans d'autres packages, seul l'identifiant public est accessible :

package main

import (
    "example.com/utils"
    "fmt"
)

func main() {
    fmt.Println(utils.Pi)
    utils.PrintMessage("Hello")
}

Ouvrez un terminal dans le répertoire et exécutez la commande suivante :

go run .

affichera 3.14159 et Bonjour.

4. Contrôle de version

Dans Golang, utilisez le fichier go.mod pour la gestion des versions. Le fichier go.mod définit le nom, les informations de version et les informations de dépendance du module actuel.

Supposons que nous souhaitions utiliser un package tiers nommé utils dans le projet hello. Nous pouvons utiliser la commande suivante pour l'ajouter à la liste des dépendances :

go get example.com/utils@v1.0.0

Cette commande téléchargera la version v1.0.0 du package tiers nommé. utils et ajoutez-le à la liste des dépendances. Dans le fichier go.mod, le contenu suivant sera ajouté :

module example.com/hello

go 1.16

require example.com/utils v1.0.0

Lors de l'utilisation d'un package tiers dans le code, vous pouvez directement importer le nom de son package, par exemple :

package main

import (
    "example.com/utils"
    "fmt"
)

func main() {
    fmt.Println(utils.Pi)
    utils.PrintMessage("Hello")
}

5. Commentaires sur la documentation

Dans Golang , utiliser les commentaires de documentation. Peut générer de la documentation et améliorer la lisibilité du code. Les commentaires de la documentation commencent par // ou / / et précèdent l'identifiant. Lors de la génération de documentation à l'aide de l'outil godoc, elles seront analysées dans la documentation.

Par exemple, voici un exemple de fonction avec des commentaires de documentation :

package utils

// add 函数计算两个整数的和。
func add(x int, y int) int {
    return x + y
}

Lors de l'utilisation de l'outil godoc pour générer de la documentation, ce qui suit sera affiché :

FUNCTIONS

func add(x int, y int) int
    add 函数计算两个整数的和。

Résumé

Cet article présente les concepts de base du package Golang configuration, y compris le nom des packages, le chemin d'importation, la visibilité, le contrôle de version et les commentaires sur la documentation, etc. Ces concepts constituent les connaissances de base pour organiser le code à l'aide de Golang. Leur maîtrise peut rendre votre code Golang plus standardisé, plus facile à maintenir et à développer.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!