Последний релиз Go, версия 1.27, выходит в августе 2026 года, спустя шесть месяцев после Go 1.26. Большинство изменений касаются реализации инструментальной цепочки, среды исполнения и библиотек. Как и раньше, релиз сохраняет обещание совместимости Go 1. Ожидается, что почти все программы на Go продолжат компилироваться и выполняться как прежде.
Изменения в языке
Go 1.27 теперь поддерживает обобщённые методы: объявление метода может задавать собственные параметры типа. Это давно ожидаемое изменение позволяет добавлять обобщённые функции в пространство имён конкретного типа данных, тогда как раньше такие функции приходилось объявлять с областью видимости на весь пакет. Например, math/rand/v2 теперь также объявляет обобщённый метод с сигнатурой (*Rand) N[Int intType](Int) Int, тогда как прежде у него была только обобщённая функция N[Int intType](Int) Int (подробности ниже). Обратите внимание, что методы интерфейсов не могут объявлять параметры типа, равно как и методы интерфейсов не могут реализовываться обобщёнными методами.
Ключ в составном литерале структуры теперь может быть любым допустимым селектором поля для этого типа структуры, а не только именем поля верхнего уровня.
Вывод типов функций был обобщён и теперь применяется во всех контекстах, где обобщённая функция присваивается переменной соответствующего типа функции или приводится к нему.
Инструменты
Теперь поддерживается разбор файлов ответов (@file) для инструментов compile, link, asm, cgo, cover и pack. Файл ответов содержит аргументы, разделённые пробелами, с поддержкой строк в одинарных и двойных кавычках, escape-последовательностей и продолжения строки с помощью обратной косой черты и перевода строки. Формат совместим с реализацией файлов ответов в GCC, чтобы обеспечить взаимодействие с существующими системами сборки.
Команда go
Команда go больше не поддерживает систему контроля версий bzr. Она больше не сможет напрямую загружать модули, размещённые на серверах bzr.
GODEBUG
Начиная с Go 1.27 команда go распознаёт настройку GODEBUG, поддержка которой была удалена (например, asynctimerchan, см. ниже), если она встречается в файлах go.mod (записи godebug) и исходных файлах .go (комментарии //go:debug). Такая настройка принимается, если для неё задано итоговое значение по умолчанию, установленное до удаления поддержки. Если же задано старое значение, команда go завершится ошибкой. Это изменение сделано в духе гарантии совместимости Go 1: существующие программы, задающие поддерживаемые настройки GODEBUG, могут и дальше собираться и запускаться без изменений даже после того, как поддержка соответствующей настройки была удалена.
go test
go test теперь по умолчанию вызывает проверку vet stdversion. Она сообщает об использовании символов стандартной библиотеки, которые слишком новы для версии Go, действующей в файле, где они используются; версия определяется директивой go в go.mod и тегами сборки файла.
go test -json теперь добавляет к строкам "Action":"output" новое необязательное поле "OutputType", задающее тип вывода. Сейчас возможны значения «error», «error-continue» и «frame». Подробности — в справке cmd/test2json.
go doc
Команда go doc теперь поддерживает синтаксис package@version, например go doc example.com/pkg@v1.2.3.
Команда go doc теперь принимает флаг командной строки -ex, чтобы вывести список исполняемых примеров для заданного пакета или символа. Если в командной строке передано имя примера (например, go doc bytes.ExampleBuffer), go doc теперь печатает исходный код примера вместе с комментариями.
go fix
Команда go fix содержит несколько новых модернизаторов: atomictypes, embedlit, slicesbackward и unsafefuncs.
Существующий анализатор fmtappendf был удалён по причинам стилистического характера.
Существующий анализатор waitgroup переименован в waitgroupgo, чтобы избежать неоднозначности.
go mod tidy
Для модулей, указывающих go 1.27 или новее в файле go.mod, go mod tidy теперь автоматически объединяет дублирующиеся блоки require. Это обеспечивает чистую стандартную структуру файла, содержащую не более двух блоков require: один для прямых зависимостей и один для косвенных.
Существующие блоки комментариев, относящиеся к зависимостям, сохраняются при такой консолидации. Если блок комментариев связан со смешанным набором директив (содержащим как прямые, так и косвенные зависимости), блок комментариев объединяется и привязывается к новому блоку прямых зависимостей.
Раньше, если в файле go.mod накапливалось несколько несвязанных блоков require (часто из-за ручного редактирования, неразрешённых конфликтов слияния в Git или устаревших обновлений), go mod tidy оставлял лишние блоки нетронутыми или мог нечаянно создать новые. Теперь инструмент строго соблюдает структуру из двух блоков, объединяя разрозненные требования в соответствующие блоки и автоматически приводя структуру файла модуля в порядок.
Gofmt
В этом выпуске исправлена логика, которую gofmt (и go/format) использует при выборе выравнивания столбцов. Прежняя логика приводила к тому, что поведение gofmt слегка различалось на разных архитектурах CPU. Новая логика меняет решение о выравнивании для небольшого числа файлов, поэтому запуск gofmt из Go 1.27 на ранее отформатированном коде может привести к незначительным изменениям пробелов.
Vet
Анализатор printf теперь сообщает о вызовах вида fmt.Errorf("...: %w", p), где операнд p при %w имеет тип *E, при этом сам тип E реализует error. Обёртывание указателя таким образом обычно является скрытой ошибкой, поскольку ведёт к ложным сбоям операций, проверяющих конкретный тип ошибки, таких как утверждение типа или вызов errors.Is.
Trace
Флаг командной строки -http инструмента go tool trace теперь ограничивает адрес прослушивания localhost, если передан только порт (например, -http=:6060). Это изменение делает go tool trace согласованным с поведением флага -http инструмента go tool pprof. Чтобы прослушивать все адреса, явно укажите нужный адрес (например, -http=0.0.0.0:6060).
Среда исполнения (runtime)
Трассировки для модулей с директивой go, задающей Go 1.27 или новее, теперь включают метки горутин runtime/pprof в строке заголовка. Это поведение можно отключить настройкой GODEBUG tracebacklabels=0 (добавлена в Go 1.26). Ожидается, что возможность отключения сохранится неопределённо долго — на случай, если метки горутин содержат конфиденциальную информацию, которую не следует включать в трассировки.
Настройка GODEBUG asynctimerchan (добавленная в Go 1.23) полностью удалена. Каналы, создаваемые пакетом time, теперь всегда небуферизированные (синхронные), независимо от настроек GODEBUG.
Более быстрое выделение памяти
Теперь компилятор генерирует вызовы подпрограмм выделения памяти, специализированных по размеру, что снижает стоимость некоторых малых (менее 80 байт) выделений до 30%. Улучшения зависят от рабочей нагрузки, но в целом ожидается прирост около 1% в реальных программах с активным выделением памяти. Размер бинарного файла при этом увеличивается примерно на 60 КБ (независимо от рабочей нагрузки). Пожалуйста, сообщите об ошибке, если вы заметите регрессии. Отключить эту возможность можно установкой GOEXPERIMENT=nosizespecializedmalloc при сборке. Ожидается, что настройка отключения будет удалена в Go 1.28.
Профиль утечек горутин
Новый тип профиля, сообщающий об утечках горутин и ранее доступный как эксперимент в Go 1.26, теперь общедоступен. Тип профиля под названием goroutineleak поддерживается в пакете runtime/pprof, а также доступен как эндпоинт /debug/pprof/goroutineleak пакета net/http/pprof.
Утечной горутиной называется горутина, заблокированная на примитиве параллелизма (каналы, sync.Mutex, sync.Cond и т. д.), который не может быть разблокирован. Среда исполнения обнаруживает утечные горутины с помощью сборщика мусора: если горутина G заблокирована на примитиве P и P недостижим из какой-либо запускаемой горутины или из горутин, которые те могут разблокировать, значит P не может быть разблокирован и горутина G никогда не проснётся. Хотя во всех случаях обнаружить навсегда заблокированные горутины невозможно, этот подход выявляет большой класс таких утечек.
Поскольку метод основан на достижимости, среда исполнения может не распознать утечки, вызванные блокировкой на примитивах параллелизма, достижимых через глобальные переменные или локальные переменные запускаемых горутин.
Пример приведён в заметках о выпуске Go 1.26.
Особая благодарность Vlad Saioc из Uber за вклад в эту работу.
Настройка GOEXPERIMENT goroutineleakprofile теперь удалена.
Компилятор
Компилятор теперь разрешает относительное имя файла в директиве //line или /*line*/ относительно каталога файла, содержащего директиву, в соответствии с поведением go/scanner. Абсолютные имена файлов не затрагиваются. См. #70478.
Компилятор теперь генерирует более простые имена для функциональных литералов (замыканий). Прежде, когда содержащая функция инлайнилась, имя функционального литерала могло становиться довольно длинным. Теперь компилятор выбирает одно и то же имя для функционального литерала независимо от инлайнинга. Он также может объединять несколько экземпляров одного и того же литерала (по мере инлайнинга содержащей функции), чтобы использовать общий код в скомпилированном бинарном файле. Это изменение не влияет на функциональность кода Go. Тесты, проверяющие имена символов, могут потребовать обновления, хотя рекомендуется не полагаться на имена функциональных литералов. Для программ, которые некорректно сравнивают указатели на код функции на равенство, проблема может проявляться чаще в Go 1.27, поскольку литералы с разными захваченными данными замыкания будут чаще иметь одинаковые указатели на код.
Линкер
При сборке для macOS линкер теперь принимает флаги командной строки -macos и -macsdk, задающие версии ОС и SDK в команде загрузки LC_BUILD_VERSION. По умолчанию выбирается самая старая поддерживаемая версия macOS (сейчас 13.0.0) и недавняя версия SDK (сейчас 26.2.0).
Стандартная библиотека
Новые пакеты encoding/json/v2 и encoding/json/jsontext
Теперь доступны два новых пакета:
- Пакет
encoding/json/v2— радикальная переработкаencoding/json. Он предоставляетMarshal,MarshalWrite,MarshalEncode,Unmarshal,UnmarshalReadиUnmarshalDecode; все они принимают произвольное число аргументовOptionsдля настройки маршалинга и анмаршалинга. - Пакет
encoding/json/jsontextобеспечивает более низкоуровневую синтаксическую обработку JSON. ТипыEncoderиDecoderработают с JSON как с последовательностьюTokenиValue, поддерживая конечный автомат, который гарантирует корректность создаваемого или потребляемого текста JSON.
Пакет v2 использует более строгие и лучше совместимые с другими системами значения по умолчанию, чем v1: он отклоняет некорректную UTF-8 в строках JSON и повторяющиеся имена внутри объекта JSON. Полный набор различий в поведении и параметры для их настройки приведены в документации пакета v1 encoding/json.
Пакет encoding/json теперь работает на реализации v2. Поведение маршалинга и анмаршалинга сохранено, но точный текст сообщений об ошибках может отличаться. Пакет также получил ряд новых Options, которые позволяют настроить v2 на работу с семантикой v1, чтобы не требовать полного перехода на новый API. API v1 и дальше будет поддерживаться, и мигрировать на него не обязательно.
Производительность маршалинга в целом сопоставима с предыдущей реализацией, а анмаршалинга — значительно выше.
Пользователи, у которых возникают проблемы совместимости с новой реализацией, могут отключить её, установив GOEXPERIMENT=nojsonv2 при сборке; это вернёт исходную реализацию v1. Ожидается, что возможность отключения будет удалена в будущем выпуске.
Среди заметных изменений encoding/json/v2 в период GOEXPERIMENT — следующие удаления: опция тега format (#79071), опция тега unknown (#77271), опция маршалинга DiscardUnknownMembers (#77271) и маркерная ошибка SkipFunc (#74324). Кроме того, опция тега inline переименована в embed (#79985), а поведение опции тега string и опции MatchCaseInsensitiveNames было обновлено (CL 792780). В encoding/json/jsontext числовые аксессоры Token теперь также возвращают ошибки (#77666).
Предыстория и дополнительные детали — в issue с предложением. Если вам нужно отключить новую реализацию, создайте issue.
Новый пакет crypto/mldsa
Новый пакет crypto/mldsa реализует постквантовую схему подписи ML-DSA, описанную в FIPS 204.
crypto/x509 теперь поддерживает закрытые ключи, открытые ключи и подписи ML-DSA.
crypto/tls теперь поддерживает подписи ML-DSA в TLS 1.3 с новыми значениями SignatureScheme: MLDSA44, MLDSA65 и MLDSA87.
Новый пакет uuid
Новый пакет uuid создаёт и разбирает UUID.
Новый экспериментальный пакет simd
Go 1.27 представляет новый экспериментальный пакет simd, обеспечивающий переносимую поддержку SIMD, не зависящую от размера вектора. Он использует аппаратные инструкции, если они доступны. Пакет включается установкой переменной окружения GOEXPERIMENT=simd при сборке.
Пакет simd доступен на всех архитектурах и предоставляет векторные типы неопределённого размера, такие как Int8s и Float32s. Он поддерживает «масштабируемое» подмножество операций из пакета simd/archsimd, которые поддерживаются аппаратно или легко эмулируются на разных архитектурах и разной ширине вектора.
Подробности — в issue с предложением.
Экспериментальный пакет simd/archsimd
Go 1.27 продолжает экспериментальную поддержку SIMD-операций в пакете simd/archsimd, начатую в Go 1.26. В этом выпуске переработан API для amd64 и добавлена поддержка 128-битного SIMD «Neon» для arm64 и 128-битного SIMD для WebAssembly. Пакет simd/archsimd включается установкой переменной окружения GOEXPERIMENT=simd при сборке.
Пакет предоставляет доступ к архитектурно-зависимым SIMD-операциям. Он поддерживает 128-битные векторные типы на wasm, arm64 и amd64, а также 256- и 512-битные типы на некоторых процессорах amd64. API пока не считается стабильным.
Подробности — в документации пакета и в issue с предложением.
Мы намерены добавить поддержку других архитектур в будущих версиях, но API намеренно архитектурно-зависим и, следовательно, не переносим.
Go 1.27 — Незначительные изменения в библиотеке
bytes
Новая функция CutLast разрезает []byte вокруг последнего вхождения разделителя. Она может заменить и упростить некоторые типичные способы использования LastIndex.
compress/flate
Скорость сжатия улучшена в Go 1.27. Точный закодированный результат Writer может отличаться от Go 1.26 из-за изменения реализации кодера. Поскольку DEFLATE — это базовый метод сжатия, используемый в archive/zip, compress/gzip, compress/zlib и image/png, результаты этих пакетов также могли измениться.
crypto
Добавлено новое значение Hash — MLDSAMu, используемое как сигнал для внешней подписи ML-DSA (External μ).
crypto/ecdsa
PrivateKey.Sign теперь проверяет длину хеша, если передан не-nil SignerOpts.
crypto/tls
Новое поле QUICConfig.ClientHelloInfoConn задаёт net.Conn, используемое для поля ClientHelloInfo.Conn при рукопожатии QUIC-сервера.
Теперь поддерживается обмен ключами MLKEM1024. Его можно включить, добавив в Config.CurvePreferences.
Config.Rand устарел. Для детерминированного тестирования используйте testing/cryptotest.SetGlobalRandom.
Постквантовые гибридные обмены ключами теперь можно явно включать в Config.CurvePreferences даже при использовании настроек GODEBUG tlsmlkem=0 или tlssecpmlkem=0. Эти настройки изначально предназначались только для набора по умолчанию, применяемого, когда Config.CurvePreferences равен nil.
Новое поле ConnectionState.LocalCertificate содержит цепочку сертификатов, представленную узлу соединения во время рукопожатия.
Настройки GODEBUG tlsunsafeekm (добавлена в Go 1.22), tlsrsakex (Go 1.22), tls3des (Go 1.23), tls10server (Go 1.22) и x509keypairleaf (Go 1.23) полностью удалены.
Настройка GODEBUG tlskyber (добавленная в Go 1.23) была удалена в Go 1.24, но это удаление не было задокументировано в заметках о выпуске Go 1.24; теперь оно задокументировано.
crypto/x509
При разборе в поля pkix.Name теперь поддерживается более широкий набор типов pkix.AttributeTypeAndValue.Value, а неизвестные типы разбираются в asn1.RawValue.
Новые поля Certificate.RawSignatureAlgorithm, CertificateRequest.RawSignatureAlgorithm и RevocationList.RawSignatureAlgorithm предоставляют закодированный в DER AlgorithmIdentifier алгоритма подписи, в том числе когда поле SignatureAlgorithm равно UnknownSignatureAlgorithm.
SystemCertPool теперь учитывает SSL_CERT_FILE и SSL_CERT_DIR в Windows и Darwin. Когда эти переменные окружения заданы, корневые сертификаты загружаются с диска и вместо платформенных API проверки сертификатов используется собственный Go-верификатор. Это поведение можно отключить настройкой GODEBUG=x509sslcertoverrideplatform=0.
crypto/x509/pkix
RDNSequence.String (и, следовательно, Name.String) теперь выводит строковые значения атрибутов как строки, даже если OID атрибута не распознан. Раньше такие значения всегда кодировались в шестнадцатеричном виде в их DER-форме. См. #33093.
database/sql
Новая функция ConvertAssign предоставляет драйверам баз данных доступ к преобразованиям типов, выполняемым Rows.Scan.
database/sql/driver
Драйверы могут реализовать новый интерфейс RowsColumnScanner для сканирования напрямую в предоставляемые пользователем получатели.
go/constant
Новая функция StringLen возвращает длину строкового Value, не создавая Value целиком.
go/scanner
Сканер теперь позволяет получить конечную позицию токена через новый метод Scanner.End.
go/types
Тип Hasher — это реализация maphash.Hasher для Type, учитывающая отношение эквивалентности Identical; это позволяет использовать типы в хеш-таблицах и аналогичных структурах данных. HasherIgnoreTags — аналогичный хешер для IdenticalIgnoreTags.
Настройка GODEBUG gotypesalias (добавленная в Go 1.22) полностью удалена, и пакет go/types теперь всегда создаёт узел типа Alias для объявлений псевдонимов независимо от настроек GODEBUG.
hash/maphash
Тип интерфейса Hasher задаёт контракт между значениями конкретного типа и будущими структурами данных на основе хеширования, такими как хеш-таблицы и фильтры Блума; см. #70471.
Тип ComparableHasher предоставляет удобную реализацию Hasher для сравниваемых типов, в которых метод Equal определён как ==.
math/big
Int теперь имеет метод Divide для вычисления частного и остатка от двух значений Int. Поддерживаются режимы округления Trunc, Floor, Round и Ceil.
math/rand/v2
Rand теперь поддерживает обобщённый метод N, соответствующий поведению функции верхнего уровня N.
net
Методы чтения UnixConn теперь возвращают io.EOF напрямую вместо обёртывания в net.OpError, когда базовое чтение возвращает EOF.
net/http
Transport и Server поддерживают согласование протокола TLS ALPN на предоставляемых пользователем соединениях net.Conn, реализующих метод ConnectionState() tls.ConnectionState.
HTTP/2-сервер теперь принимает сигналы приоритета клиента, описанные в RFC 9218, что позволяет ему в первую очередь обслуживать потоки HTTP/2 с более высоким приоритетом. Если предпочтительно старое поведение, когда потоки обслуживаются по круговой очереди независимо от приоритета, можно установить Server.DisableClientPriority в true.
HTTP/1 Response.Body теперь автоматически считывает и отбрасывает непрочитанное содержимое при закрытии — вплоть до консервативного предела, — чтобы улучшить повторное использование соединений. Для большинства программ это изменение должно быть незаметным или привести к улучшению производительности. В редких случаях программы, которые не выигрывают от повторного использования соединений, могут заметить ухудшение производительности, если прежде допускали слишком много долго простаивающих соединений — обычно путём установки Transport.MaxIdleConns в 0 или использования разных Client для разных запросов, что обходит ограничение Transport.MaxIdleConns. В таких случаях установка Transport.DisableKeepAlives в true отключит повторное использование соединений. Впрочем, подобное ухудшение обычно говорит о некорректной конфигурации или использовании Transport или Client, и более внимательный разбор, вероятно, будет полезным.
Новое поле Server.MaxHeaderValueCount позволяет HTTP-серверам контролировать число значений заголовков, которые они готовы принять. Если поле не задано, используется DefaultMaxHeaderValueCount.
net/http/httptest
Новая функция NewTestServer создаёт Server, настроенный на использование встроенной фиктивной сети, подходящей для работы с пакетом testing/synctest.
net/url
Новый метод URL.Clone создаёт глубокую копию URL. Новый метод Values.Clone создаёт глубокую копию Values.
runtime/secret
Горутины, создаваемые в режиме секретности, теперь сами выполняются в этом режиме.
strings
Новая функция CutLast разрезает строку вокруг последнего вхождения разделителя. Она может заменить и упростить некоторые типичные способы использования LastIndex.
syscall
В Plan 9 тип Errno теперь определён и реализует интерфейс error, как и на других платформах. Системные вызовы Plan 9 возвращают значения ErrorString, поэтому Errno никогда не возвращается этим пакетом в Plan 9. Тип определён для того, чтобы переносимый код, ссылающийся на syscall.Errno, собирался в Plan 9 без тегов сборки.
testing/synctest
Новая вспомогательная функция Sleep объединяет time.Sleep и synctest.Wait.
unicode
Пакет unicode и соответствующая поддержка во всей системе обновлены с Unicode 15 до Unicode 17. Об изменениях см. заметки о выпуске Unicode 16.0.0 и Unicode 17.0.0.
Порты
Darwin
Как было объявлено в заметках о выпуске Go 1.26, Go 1.27 требует macOS 13 Ventura или новее; поддержка предыдущих версий прекращена.
PowerPC
На big-endian 64-битном порту PowerPC в Linux (GOOS=linux, GOARCH=ppc64) инструментальная цепочка Go теперь генерирует бинарные файлы, использующие системный ABI ELFv2. Поддержка ELFv2 требует ядра Linux 3.13 или новее. RHEL7 перенесла эту поддержку в своё ядро 3.10.
Cgo, позиционно-независимые исполняемые файлы (PIE) и внешнее связывание теперь поддерживаются. Использование этих возможностей требует совместимой с ELFv2 среды исполнения (libc и всех связанных и загружаемых библиотек).
Для программ, не использующих cgo, инструментальная цепочка Go по-прежнему по умолчанию создаёт статические бинарные файлы с внутренним связыванием. Для программ с опциями cgo, если нужен статический чистый Go-бинарный файл, можно установить переменную окружения CGO_ENABLED=0 при запуске go build.
Читайте также:
