Help us shape the future of Go! Take the 2026 Go Developer Survey

Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

config

package

Go to main page

Versions in this module

v2

v2.4.4

Nov 8, 2025

v2.4.2

Oct 16, 2025

v2.4.1

Oct 16, 2025

v2.3.4

Sep 13, 2025

v2.3.2

Sep 4, 2025

v2.3.1

Aug 31, 2025

v2.2.8

Jul 20, 2025

Changes in this version

+ func Close()

+ func Get(pattern string, def ...interface{}) value.Value

+ func Has(pattern string) bool

+ func Set(pattern string, value interface{}) error

+ func SetConfigurator(configurator Configurator)

+ func SetConfiguratorWithSources(sources ...Source)

+ func Store(ctx context.Context, source string, file string, content interface{}, ...) error

+ func Watch(cb WatchCallbackFunc, names ...string)

+ type Configuration struct

+ Content []byte

+ File string

+ Format string

+ FullPath string

+ Name string

+ Path string

+ func Load(ctx context.Context, source string, file ...string) ([]*Configuration, error)

+ func (c *Configuration) Decode() (interface{}, error)

+ func (c *Configuration) Scan(dest interface{}) error

+ type Configurator interface

+ Close func()

+ Get func(pattern string, def ...interface{}) value.Value

+ Has func(pattern string) bool

+ Load func(ctx context.Context, source string, file ...string) ([]*Configuration, error)

+ Match func(patterns ...string) Matcher

+ Set func(pattern string, value interface{}) error

+ Store func(ctx context.Context, source string, file string, content interface{}, ...) error

+ Watch func(cb WatchCallbackFunc, names ...string)

+ func GetConfigurator() Configurator

+ func NewConfigurator(opts ...Option) Configurator

+ type Decoder func(format string, content []byte) (interface{}, error)

+ type Encoder func(format string, content interface{}) ([]byte, error)

+ type Matcher interface

+ Get func(def ...interface{}) value.Value

+ Has func() bool

+ Scan func(dest interface{}) error

+ func Match(patterns ...string) Matcher

+ type Mode string

+ const ReadOnly

+ const ReadWrite

+ const WriteOnly

+ type Option func(o *options)

+ func WithContext(ctx context.Context) Option

+ func WithDecoder(decoder Decoder) Option

+ func WithEncoder(encoder Encoder) Option

+ func WithSources(sources ...Source) Option

+ type Scanner func(format string, content []byte, dest interface{}) error

+ type Source interface

+ Close func() error

+ Load func(ctx context.Context, file ...string) ([]*Configuration, error)

+ Name func() string

+ Store func(ctx context.Context, file string, content []byte) error

+ Watch func(ctx context.Context) (Watcher, error)

+ type WatchCallbackFunc func(names ...string)

+ type Watcher interface

+ Next func() ([]*Configuration, error)

+ Stop func() error