Aliased Import

An aliased import in Go binds an imported package to a custom local identifier instead of its default package name. This custom identifier dictates how the package’s exported constants, variables, functions, and types are accessed within the lexical scope of the importing file.

Syntax

The alias is declared immediately preceding the package path string in the import declaration.

import alias_name "path/to/package"

When grouped in an import block:

import (
    "fmt"
    cr "crypto/rand"
    mr "math/rand"
)

Lexical Mechanics

• Identifier Replacement: Once a package is aliased, its original declared package name becomes inaccessible in that file. Attempting to reference the default name results in an undeclared name compilation error.
• File-Level Scope: The alias is strictly scoped to the file containing the import declaration. Other files within the same Go package must declare their own imports and are unaffected by aliases in adjacent files.

package main

import (
    "fmt"
    str "strings"
)

func main() {
    // The package 'strings' is accessed exclusively via the 'str' identifier.
    // Calling strings.ToUpper() here would cause a compilation error.
    result := str.ToUpper("syntax") 
    fmt.Println(result)
}

Special Alias Operators

Go defines two reserved alias operators that alter the standard namespace binding behavior:

1. The Blank Identifier (_) Aliasing an import with the blank identifier prevents the compiler from binding the package to a local name. It executes the imported package’s init() functions and initializes its global variables, but the package’s exported identifiers remain inaccessible.

// Executes the init() function in image/png to register the PNG decoder,
// but does not expose the package's identifiers to the current file.
import _ "image/png"

2. The Dot Operator (.) Aliasing with a dot operator merges the imported package’s exported identifiers directly into the importing file’s lexical block. The exported members are accessed directly without any package qualifier.

import . "math"

func calculate() float64 {
    // Pi and Sin are accessed without the "math." prefix
    return Sin(Pi / 2) 
}

Best Practice Warning: The use of dot imports is strongly discouraged in standard production code. Because it merges namespaces, it obscures the origin of identifiers and pollutes the file’s namespace, severely reducing code readability and maintainability. Dot imports are almost exclusively intended for use in test files, where they can be used to resolve circular dependencies or simplify repetitive test assertions.

Master Go with Deep Grasping Methodology!

Learn More