# go fix與go tool fix
命令```go fix```會把指定代碼包的所有Go語言源碼文件中的舊版本代碼修正為新版本的代碼。這里所說的版本即Go語言的版本。代碼包的所有Go語言源碼文件不包括其子代碼包（如果有的話）中的文件。修正操作包括把對舊程序調用的代碼更換為對新程序調用的代碼、把舊的語法更換為新的語法，等等。
這個工具其實非常有用。在編程語言的升級和演進的過程中，難免會對過時的和不夠優秀的語法及標準庫進行改進。這樣的改進對于編程語言的向后兼容性是個挑戰。我們在前面提到過向后兼容這個詞。簡單來說，向后兼容性就是指新版本的編程語言程序能夠正確識別和解析用該編程語言的舊版本編寫的程序和軟件，以及在新版本的編程語言的運行時環境中能夠運行用該編程語言的舊版本編寫的程序和軟件。對于Go語言來說，語法的改變和標準庫的變更都會使得用舊版本編寫的程序無法在新版本環境中編譯通過。這就等于破壞了Go語言的向后兼容性。對于一個編程語言、程序庫或基礎軟件來說，向后兼容性是非常重要的。但有時候為了讓軟件更加優秀，軟件的開發者或維護者不得不在向后兼容性上做出一些妥協。這是一個在多方利益之間進行權衡的結果。本小節所講述的工具正是Go語言的創造者們為了不讓這種妥協給語言使用者帶來困擾和額外的工作量而編寫的自動化修正工具。這也充分體現了Go語言的軟件工程哲學。下面讓我們來詳細了解它們的使用方法和內部機理。
命令```go fix```其實是命令```go tool fix```的簡單封裝。這甚至比```go fmt```命令對```gofmt```命令的封裝更簡單。像其它的Go命令一樣，```go fix```命令會先對作為參數的代碼包導入路徑進行驗證，以確保它是正確有效的。像在本小節開始處描述的那樣，```go fix```命令會把有效代碼包中的所有Go語言源碼文件作為多個參數傳遞給```go tool fix```命令。實際上，```go fix```命令本身不接受任何標記，它會把加入的所有標記都原樣傳遞給```go tool fix```命令。```go tool fix```命令可接受的標記如下表。
_表0-15 ```go tool fix```命令的標記說明_
<table class="table table-bordered table-striped table-condensed">
<tr>
<th width=25%>
標記名稱
</th>
<th>
標記描述
</th>
</tr>
<tr>
<td>
-diff
</td>
<td>
不將修正后的內容寫入文件，而只打印修正前后的內容的對比信息到標準輸出。
</td>
</tr>
<tr>
<td>
-r
</td>
<td>
只對目標源碼文件做有限的修正操作。該標記的值即為允許的修正操作的名稱。多個名稱之間用英文半角逗號分隔。
</td>
</tr>
<tr>
<td>
-force
</td>
<td>
使用此標記后，即使源碼文件中的代碼已經與Go語言的最新版本相匹配了，也會強行執行指定的修正操作。該標記的值就是需要強行執行的修正操作的名稱，多個名稱之間用英文半角逗號分隔。
</td>
</tr>
<table>
在默認情況下，```go tool fix```命令程序會在目標源碼文件上執行所有的修正操作。多個修正操作的執行會按照每個修正操作中標示的操作建立日期以從早到晚的順序進行。我們可以通過執行```go tool fix -?```來查看```go tool fix```命令的使用說明以及當前支持的修正操作。
與本書對應的Go語言版本的```go tool fix```命令目前只支持兩個修正操作。一個是與標準庫代碼包```go/printer```中的結構體類型```Config```的初始化代碼相關的修正操作，另一個是與標準庫代碼包``net```中的結構體類型```IPAddr```、```UDPAddr```和```TCPAddr```的初始化代碼相關的修正操作。從修正操作的數量來看，自第一個正式版發布以來，Go語言的向后兼容性還是很好的。從Go語言官網上的說明也可以獲知，在Go語言的第二個大版本（Go 2.x）出現之前，它會一直良好的向后兼容性。
值得一提的是，上述的修正操作都是依靠Go語言的標準庫代碼包```go```及其子包中提供的功能來完成的。實際上，```go tool fix```命令程序在執行修正操作之前，需要先將目標源碼文件中的內容解析為一個抽象語法樹實例。這一功能其實就是由代碼包```go/parser```提供的。而在這個抽象語法樹實例中的各個元素的結構體類型的定義以及檢測、訪問和修改它們的方法則由代碼包```go/ast```提供。有興趣的讀者可以閱讀這些代碼包中的代碼。這對于深入理解Go語言對代碼的靜態處理過程是非常有好處的。
回到正題。與```gofmt```命令相同，```go tool fix```命令也有交互模式。我們同樣可以通過執行不帶任何參數的命令來進入到這個模式。但是與```gofmt```命令不同的是，我們在```go tool fix```命令的交互模式中輸入的代碼必須是完整的，即必須要符合Go語言源碼文件的代碼組織形式。當我們輸入了不完整的代碼片段時，命令程序將顯示錯誤提示信息并退出。示例如下：
hc@ubt:~$ go tool fix -r='netipv6zone'
a := &net.TCPAddr{ip4, 8080}
standard input:1:1: expected 'package', found 'IDENT' a
相對于上面的示例，我們必須要這樣輸入源碼才能獲得正常的結果：
hc@ubt:~$ go tool fix -r='netipv6zone'
package main
import (
"fmt"
"net"
)
func main() {
addr := net.TCPAddr{"127.0.0.1", 8080}
fmt.Printf("TCP Addr: %s\n", addr)
}
standard input: fixed netipv6zone
package main
import (
"fmt"
"net"
)
func main() {
addr := net.TCPAddr{IP: "127.0.0.1", Port: 8080}
fmt.Printf("TCP Addr: %s\n", addr)
}
上述示例的輸出結果中有這樣一行提示信息：“standard input: fixed netipv6zone”。其中，“standard input”表明源碼是從標準輸入而不是源碼文件中獲取的，而“fixed netipv6zone”則表示名為netipv6zone的修正操作發現輸入的源碼中有需要修正的地方，并且已經修正完畢。另外，我們還可以看到，輸出結果中的代碼已經經過了格式化。
