Go 1.18 is not yet released. These are work-in-progress release notes. Go 1.18 is expected to be released in February 2022.
TODO: complete this section
Go 1.18 is the last release that is supported on FreeBSD 11.x, which has already reached end-of-life. Go 1.19 will require FreeBSD 12.2+ or FreeBSD 13.0+. FreeBSD 13.0+ will require a kernel with the COMPAT_FREEBSD12 option set (this is the default).
TODO: https://golang.org/cl/353969: internal/buildcfg: enable register ABI for PPC64
The 64-bit RISC-V architecture on Linux (the linux/riscv64
port)
now supports the c-archive
and c-shared
build modes.
go
get
no longer builds or installs packages in
module-aware mode. go
get
is now dedicated to
adjusting dependencies in go.mod
. Effectively, the
-d
flag is always enabled. To install the latest version
of an executable outside the context of the current module, use
go
install
example.com/cmd@latest
. Any
version query
may be used instead of latest
. This form of go
install
was added in Go 1.16, so projects supporting older
versions may need to provide install instructions for both go
install
and go
get
. go
get
now reports an error when used outside a module, since there
is no go.mod
file to update. In GOPATH mode (with
GO111MODULE=off
), go
get
still builds
and installs packages, as before.
The go
command now embeds version control information in
binaries including the currently checked-out revision, commit time, and a
flag indicating whether edited or untracked files are present. Version
control information is embedded if the go
command is invoked in
a directory within a Git, Mercurial, Fossil, or Bazaar repository, and the
main
package and its containing main module are in the same
repository. This information may be omitted using the flag
-buildvcs=false
.
Additionally, the go
command embeds information about the build
including build and tool tags (set with -tags
), compiler,
assembler, and linker flags (like -gcflags
), whether cgo was
enabled, and if it was, the values of the cgo environment variables
(like CGO_CFLAGS
). This information may be omitted using the
flag -buildinfo=false
. Both VCS and build information may be
read together with module information using go
version
-m
file
or
runtime/debug.ReadBuildInfo
(for the currently running binary)
or the new debug/buildinfo
package.
If the main module's go.mod
file
specifies go
1.17
or higher, go
mod
download
without
arguments now downloads source code for only the modules
explicitly required in the main
module's go.mod
file. (In a go
1.17
or
higher module, that set already includes all dependencies needed to build the
packages and tests in the main module.)
To also download source code for transitive dependencies, use
go
mod
download
all
.
TODO: https://golang.org/cl/349595: cmd/go: add GOAMD64 environment variable
gofmt
gofmt
now reads and formats input files concurrently, with a
memory limit proportional to GOMAXPROCS
. On a machine with
multiple CPUs, gofmt
should now be significantly faster.
TODO: complete this section, or delete if not needed
TODO: https://golang.org/cl/298611: cmd/compile: add -asan option
TODO: https://golang.org/cl/352057: cmd/compile, runtime: track argument stack slot liveness
TODO: https://golang.org/cl/298610: cmd/link: add -asan option
constraints
packageTODO: https://golang.org/cl/349709: constraints: new package
net/netip
package
The new net/netip
package defines a new IP address type, Addr
.
Compared to the existing
net.IP
type, the netip.Addr
type takes less
memory, is immutable, and is comparable so it supports ==
and can be used as a map key.
In addition to Addr
, the package defines
AddrPort
, representing
an IP and port, and
Prefix
, representing
a network CIDR prefix.
The net
package now has methods to send and receive UDP packets
using netip.Addr
values instead of the relatively heavy
*net.UDPAddr
values.
TODO: complete this section
As always, there are various minor changes and updates to the library, made with the Go 1 promise of compatibility in mind.
TODO: complete this section
TODO: https://golang.org/cl/345569: add Writer.AvailableBuffer
TODO: https://golang.org/cl/345570: make Reader.Reset and Writer.Reset work on the zero value
TODO: https://golang.org/cl/332771: avoid allocations in Trim/TrimLeft/TrimRight
The Title
function is now deprecated. It doesn't
handle Unicode punctuation and language-specific capitalization rules, and is superseded by the
golang.org/x/text/cases package.
TODO: https://golang.org/cl/325250: add Conn.NetConn method
This new package provides access to module versions, version control
information, and build flags embedded in executable files built by
the go
command. The same information is also available via
runtime/debug.ReadBuildInfo
for the currently running binary and via go
version
-m
on the command line.
The Draw
and DrawMask
fallback implementations
(used when the arguments are not the most common image types) are now
faster when those arguments implement the optional
draw.RGBA64Image
and image.RGBA64Image
interfaces that were added in Go 1.17.
TODO: https://golang.org/cl/340261: deprecate (net.Error).Temporary
TODO: https://golang.org/cl/338590: add Cookie.Valid method
TODO: https://golang.org/cl/330753: implement go native GroupIds
The new
Value.SetIterKey
and Value.SetIterValue
methods set a Value using a map iterator as the source. They are equivalent to
Value.Set(iter.Key())
and Value.Set(iter.Value())
but
do fewer allocations.
The new
Value.UnsafePointer
method returns the Value's value as an unsafe.Pointer
.
This allows callers to migrate from Value.UnsafeAddr
and Value.Pointer
to eliminate the need to perform uintptr to unsafe.Pointer conversions at the callsite (as unsafe.Pointer rules require).
TODO: https://golang.org/cl/321889: allocate hiter as part of MapIter
TODO: https://golang.org/cl/321891: add MapIter.Reset
TODO: https://golang.org/cl/345486: optimize for maps with string keys
TODO: https://golang.org/cl/352131: add Value.{CanInt, CanUint, CanFloat, CanComplex}
TODO: https://golang.org/cl/357962: add FieldByIndexErr
TODO: https://golang.org/cl/354569: document and implement that invalid UTF-8 bytes are the same as U+FFFD
TODO: https://golang.org/cl/343877: reject surrogate halves in Unquote
TODO: https://golang.org/cl/345849: add Clone function
TODO: https://golang.org/cl/332771: avoid allocations in Trim/TrimLeft/TrimRight
The Title
function is now deprecated. It doesn't
handle Unicode punctuation and language-specific capitalization rules, and is superseded by the
golang.org/x/text/cases package.
TODO: https://golang.org/cl/319769: add Mutex.TryLock, RWMutex.TryLock, RWMutex.TryRLock
The new function SyscallN
has been introduced for Windows, allowing for calls with arbitrary number
of arguments. As a result,
Syscall
,
Syscall6
,
Syscall9
,
Syscall12
,
Syscall15
, and
Syscall18
are
deprecated in favor of SyscallN
.
TODO: https://golang.org/cl/355570: add support for SysProcAttr.Pdeathsig on FreeBSD
TODO: https://golang.org/cl/356430: remove Wrapper interface
TODO: https://golang.org/cl/343883: increase alternation precedence
TODO: https://golang.org/cl/356669: skip extra -count iterations if there are no tests
TODO: https://golang.org/cl/321490: implement short-circuit and, or
TODO: https://golang.org/cl/345571: add AppendRune