Go 1.13 釋出說明

go build 標記 -tags 現在會採用逗號分隔的建置標記清單，允許在 GOFLAGS 中使用多個標記。空格分隔的形式已不建議使用，但仍會辨識且繼續支援。

go generate 現在會設定 generate 建置標記，以便搜尋檔案中的指令，但在建置期間忽略這些指令。

如同在 Go 1.12 發行說明中 宣布，不再支援僅限二進位的套件。建置僅限二進位的套件（使用 //go:binary-only-package 註解標示）現在會產生錯誤。

編譯器工具鏈

編譯器有一個新的逸出分析實作，更為精確。對於大部分 Go 程式碼，應該是有所改善（換句話說，更多 Go 變數和運算式會配置在堆疊上，而非記憶體堆積）。但這種精準度的提升也可能會中斷因為意外運作而失效的無效程式碼（例如，違反 unsafe.Pointer 安全規則 的程式碼）。如果您發現任何相關的退步，可以使用 go build -gcflags=all=-newescape=false 重新啟用舊的逸出分析傳遞。在未來的版本中將移除使用舊逸出分析的選項。

編譯器不再將浮點或複數常數寫入 go_asm.h 檔案中。這些常數一直都已無法用作組譯碼中的數字常數的形式寫入。

組譯器

組譯器現在支援 ARM v8.1 中引進的許多原子化指令。

gofmt

gofmt（及隨之而來的 go fmt）現將數字字面值的前置詞和指數正規化為小寫字母，但不會變動十六進制數字。如此一來在使用新的八進制前置詞（0O 變為 0o）時即可提高可讀性，且此變更已一致套用。gofmt 目前也會移除浮點數複數字面值中不必要的開頭零（為了保持向下相容性，開頭為 0 的浮點數複數字面值會視為十進位數，而非八進制數字。移除多餘開頭零可避免潛在混淆）。舉例來說，在套用 gofmt 後，0B1010、0XabcDEF、0O660、1.2E3 和 01i 將變為 0b1010、0xabcDEF、0o660、1.2e3 和 1i。

godoc 和 go doc

主二進制發行版不再包含 godoc 網路伺服器。若要執行本機 godoc 網路伺服器，請先手動安裝

go get golang.org/x/tools/cmd/godoc
godoc

go doc 指令現會在輸出中持續納入套件條款，指令例外。此變更取代之前的經驗法則，使套件條款在特定狀況下會被省略。

執行時期

超出範圍的恐慌訊息現會納入範圍外的索引和切片長度（或容量）。舉例來說，對長度為 1 的切片執行 s[3] 將會產生恐慌「執行時期錯誤：索引超出範圍 [3]，長度為 1」。

此版本改善了大多數 defer 用法的效能達 30%。

執行時期現在會更積極地將記憶體還原給作業系統，使其可用於同主機應用程式。之前，執行時期可能會在堆積大小激增後保留記憶體達五分鐘以上。作業系統縮減後，記憶體現在會很快地被歸還。不過，在許多作業系統（包括 Linux）上，作業系統本身會延後進行記憶體回收，因此處理程序 RSS 只有在系統記憶體不足時才會減少。

標準函式庫

TLS 1.3

如同 Go 1.12 中宣布，Go 1.13 已預設啟用 crypto/tls 套件中的 TLS 1.3 支援。透過將 tls13=0 值新增至 GODEBUG 環境變數，可停用這項功能。選擇停用 TLS 1.3 的機制將會在 Go 1.14 中移除。

請參閱 Go 1.12 版本說明 以取得重要的相容性資訊。

crypto/ed25519

新的 crypto/ed25519 套件實作 Ed25519 簽章方案。此功能之前是由 golang.org/x/crypto/ed25519 套件提供，在用於 Go 1.13 以上版本時，此套件會變成 crypto/ed25519 的包裝器。

錯誤包覆

Go 1.13包含對錯誤包裝支援，最初在錯誤值提案中提出並在相關議題中討論。

錯誤e可藉由提供會傳回w的Unwrap方法來包裝另一個錯誤w。e和w都可用於程式，允許e提供額外的內容至w或重新詮釋它，同時仍允許程式依據w做出決策。

為支援包裝，fmt.Errorf現在有一個%w動詞可用於建立包裝錯誤，且errors套件中有三個新函數（errors.Unwrap、errors.Is以及errors.As）簡化了解包裝和檢查包裝錯誤。

如需更多資訊，請閱讀errors套件文件或參閱錯誤值常見問題解答。稍後也會有一篇部落格文章。

程式庫的輕微變更

一如往常，程式庫有各種輕微變更和更新，考量到Go 1相容性承諾。

bytes

新的ToValidUTF8函數傳回一個給定位元組切片的副本，其中每個無效UTF-8位元組序列會由一個給定的切片取代。

context

WithValue傳回之內容的格式不再仰賴fmt，也不會以相同的方式字串化。依賴先前的確切字串化的程式碼可能會受到影響。

crypto/tls

對SSL版本3.0 (SSLv3)的支援現已不建議使用，且會在Go 1.14中移除。請注意SSLv3是先於TLS的密碼破譯協定。

在Go 1.12中，SSLv3錯誤地預設在伺服器端啟用以外，其他時間均預設停用。現在又再度預設停用。（SSLv3從未在用戶端支援。）

Ed25519憑證現在支援於TLS版本1.2和1.3。

crypto/x509

Ed25519金鑰現在支援於憑證和憑證要求中，依據RFC 8410，以及ParsePKCS8PrivateKey、MarshalPKCS8PrivateKey和ParsePKIXPublicKey函數。

現已搜尋系統根目錄的途徑包括/etc/ssl/cert.pem，用於支援Alpine Linux 3.7+的預設位置。

database/sql

新的NullTime類型代表一個可能為空的time.Time。

新的NullInt32類型代表一個可能為空的int32。

debug/dwarf

Data.Type 方法不再會在類型圖中遇到未知 DWARF 標記時發生恐慌。反之，它會使用 UnsupportedType 物件來表示類型的那個元件。

errors

新的函數 As 找出在給定錯誤的鏈中（一連串包裝過的錯誤）與給定目標類型相符的錯誤，如果是的話，就會將目標設定為該錯誤值。

新的函數 Is 報告給定錯誤值是否與另一個鏈中的錯誤相符。

新的函數 Unwrap 傳回呼叫給定錯誤上的 Unwrap 的結果（如果存在的話）。

fmt

列印動詞 %x 和 %X 現在會分別以小寫和中文字符格式化浮點數和複數。

新的列印動詞 %O 會格式化 8 進位的整數，並加上 0o 前綴。

scanner 現在會接受 16 進位的浮點數值、字元分隔底線，以及前導的 0b 和 0o 前綴。詳細資訊請參閱 語言變更。

函數 Errorf 有新的動詞 %w，其操作數必須是錯誤。Errorf 傳回的錯誤會有一個 Unwrap 方法，傳回 %w 的操作數。

go/scanner

scanner 已更新為辨識新的 Go 數字文字，特別是帶有 0b/0B 前綴的二進位文字、帶有 0o/0O 前綴的八進位文字，以及帶有 16 進位尾數的浮點數。現在可以用任何數字文字來使用虛數字尾 i，並且可以使用底線作為字元分隔符來進行分組。詳細資訊請參閱 語言變更。

go/types

類型檢查器已更新為遵循整數轉移的新規則。詳細資訊請參閱 語言變更。

html/template

當使用帶有「module」類型屬性的 <script> 標籤時，現在會將程式碼解譯為 JavaScript 模組程式碼。

log

新的 Writer 函數會傳回標準記錄器的輸出目的地。

math/big

新的 Rat.SetUint64 方法會將 Rat 設定為 uint64 值。

對於 Float.Parse，如果底數為 0，則可使用底線作為字元分隔符以提高可讀性。詳細資訊請參閱 語言變更。

針對 Int.SetString，如果基底為 0，則可以在位數之間使用底線以增強可讀性。詳情請參閱 語言變更。

Rat.SetString 現在接受非十進位的浮點表示方式。

math/bits

Add、Sub、Mul、RotateLeft 和 ReverseBytes 的執行時間現在已保證與輸入無關。

net

在設定檔 resolv.conf 中設定 use-vc 的 Unix 系統上，將使用 TCP 進行 DNS 解析。

新的欄位 ListenConfig.KeepAlive 指定偵聽器所接受的網路連線的保持連線時間。如果欄位為 0（預設值），將啟用 TCP 保持連線。若要停用，請將其設定為負值。

請注意，在保持連線逾時關閉的連線上的 I/O 所回傳的錯誤將有一個 Timeout 方法，如果呼叫會回傳 true。這使得保持連線的錯誤難以與由 SetDeadline 方法和類似方法設定的未達預定完成時間而回傳的錯誤區分。使用預定完成時間並透過 Timeout 方法或 os.IsTimeout 檢查預定完成時間的程式碼可能需要停用保持連線，或使用 errors.Is(syscall.ETIMEDOUT)（在 Unix 系統上）對保持連線超過時間會回傳 true，對預定完成時間超過時間會回傳 false。

net/http

新的欄位 Transport.WriteBufferSize 和 Transport.ReadBufferSize 允許指定 Transport 的寫入和讀取緩衝區的大小。如果任一欄位為零，則使用預設大小 4KB。

新的欄位 Transport.ForceAttemptHTTP2 控制當提供非零的 Dial、DialTLS 或 DialContext 函數或 TLSClientConfig 時是否啟用 HTTP/2。

Transport.MaxConnsPerHost 現在可以與 HTTP/2 正常運作。

TimeoutHandler 的 ResponseWriter 現在實作 Pusher 介面。

已新增狀態碼 103 "早期提示"。

Transport 現在使用 Request.Body 的 io.ReaderFrom 實作（如果有的話）來最佳化主體寫入。

在遇到不受支援的傳輸編碼時，http.Server 現在會傳回「501 實現中」狀態，這符合 HTTP 規格RFC 7230 的第 3.3.1 條。

新的 Server 欄位 BaseContext 和 ConnContext 可以更細微控制提供給要求和連線的 Context 值。

http.DetectContentType 現在可以正確偵測 RAR 簽章，且現在還可以偵測 RAR v5 簽章。

新的 Header 方法 Clone 會傳回接收者的副本。

已新增新的函式 NewRequestWithContext，它會接受控制已建立的外發 Request 整個生命週期的 Context，適合用於 Client.Do 和 Transport.RoundTrip。

當伺服器使用「408 要求逾時」回應優雅地關閉閒置連線時，Transport 不再會記錄錯誤。

os

新的 UserConfigDir 函式會傳回用於使用者特定組態資料的預設目錄。

若 File 使用 O_APPEND 旗標開啟時，其 WriteAt 方法將始終傳回錯誤。

os/exec

在 Windows 上，Cmd 的環境將始終繼承父程序的 %SYSTEMROOT% 值，除非 Cmd.Env 欄位包含其明確值。

reflect

新的 Value.IsZero 方法會報告 Value 是否為其類型的 0 值。

MakeFunc 函式現在允許在傳回值上進行指定轉換，而不必進行完全類型比對。當傳回的類型是介面類型，但實際傳回的值是實作該類型的具體值時，這非常有用。

runtime

Traceback、runtime.Caller，以及 runtime.Callers 現在會將初始化 PKG 全域變數的函式指定為 PKG.init，而不是 PKG.init.ializers。

strconv

針對 strconv.ParseFloat、strconv.ParseInt 和 strconv.ParseUint，如果基底為 0，則可在數字之間使用底線以增加可讀性。請參閱語言變更以取得詳細資訊。

strings

新的 ToValidUTF8 函式會傳回指定字串的副本，其中每一組無效的 UTF-8 位元組序列皆已由指定字串替換。

sync

現在 Mutex.Lock、Mutex.Unlock、RWMutex.Lock、RWMutex.RUnlock 和 Once.Do 的快速路徑現在會內嵌在呼叫程式中。針對 amd64 上的非爭用案例，這些變更會讓 Once.Do 快上兩倍，而 Mutex/RWMutex 方法則快上 10%。

大型 Pool 不再會增加中止世界暫停時間。

Pool 不再需要在每次 GC 時完全重新填滿。它現在會在 GC 期間保留一些物件，而非釋放所有物件，進而減少大量使用者的 Pool 負載尖峰。

syscall

_getdirentries64 的使用已從 Darwin 建置中移除，以允許 Go 二進位檔案上傳至 macOS App Store。

新增 SysProcAttr 中的 ProcessAttributes 和 ThreadAttributes 新欄位至 Windows，在建立新程序時公開安全性設定。

Windows 上的零 Chmod 模式不再回傳 EINVAL。

Errno 型別的數值可以用 errors.Is 與 os 套件中的錯誤值，例如 ErrExist，進行測試。

syscall/js

TypedArrayOf 已由 CopyBytesToGo 和 CopyBytesToJS 取代，用於在位元組切片和 Uint8Array 之間複製位元組。

testing

執行基準測試時，B.N 不再會四捨五入。

新方法 B.ReportMetric 使用者能報告自訂基準測試指標並覆寫內建指標。

現在的測試旗標登錄在新 Init 函式中，此函式由為測試所產生的 main 函式呼叫。因此，現在只有在執行測試二進位檔案時才會註冊測試旗標，而在套件初始化期間呼叫 flag.Parse 的套件可能會導致測試失敗。

text/scanner

已更新掃描器以辨識新的 Go 數字文字，特別是有 0b/0B 前置詞的二進位文字、有 0o/0O 前置詞的八進位文字，以及有十六進位尾數的浮點數字。此外，新的 AllowDigitSeparators 模式允許數字文字包含底線作為數字分隔符號（預設關閉以維護向後相容性）。詳情請參閱 語言變更。

text/template

新 切片函式 會以後續引數切片其第一個引數，並回傳結果。

time

現在，格式化和解析支援年分日數。

新的持續時間方法微秒和毫秒傳回持續時間為各自命名單位的整數計數。

unicode

unicode套件和整個系統中相關的支援已從 Unicode 10.0 升級到Unicode 11.0，新增 684 個新字元，包括七個新腳本和 66 個新表情符號。