本文详细阐述了如何在不使用`go get`命令的情况下，从源码手动构建go项目。核心在于正确配置`gopath`环境变量，并理解go项目及其依赖的目录结构。文章通过具体示例，指导读者如何手动克隆主项目，识别并逐一获取其所有依赖项，包括处理不同版本控制系统（如git和mercurial）的依赖。同时，也提供了在手动构建流程中，如何利用`go get`辅助下载项目依赖的实用技巧，旨在提升对go项目构建机制的理解。
理解Go项目构建与GOPATH
在Go语言的早期版本（如Go 1.2），项目构建和依赖管理主要依赖于GOPATH环境变量。GOPATH指定了一个或多个工作区目录，Go编译器和工具链会在此目录结构中查找源代码、编译后的包和可执行文件。标准的GOPATH结构通常包含src、pkg和bin三个子目录：
- src：存放所有Go项目的源代码，每个项目的路径都应遵循其导入路径（例如，github.com/user/repo的项目应位于$GOPATH/src/github.com/user/repo）。
- pkg：存放编译后的包文件。
- bin：存放编译后的可执行文件。
当尝试手动从源码构建Go项目时，最常见的错误是项目或其依赖没有放置在GOPATH下正确的目录结构中，导致编译器无法找到所需的包。例如，如果一个项目引用了github.com/kr/fs，Go工具链会期望在$GOPATH/src/github.com/kr/fs找到它。
手动构建Go项目的详细步骤
以下步骤演示了如何手动构建一个Go项目，并解决其依赖问题。我们将以github.com/kr/godep为例。
1. 设置GOPATH工作区
首先，需要创建一个临时的GOPATH工作区。这有助于隔离构建环境，避免与系统其他Go项目冲突。
# 创建一个临时的Go工作区目录 mkdir -p /tmp/go/src # 导出GOPATH环境变量 export GOPATH=/tmp/go # 切换到GOPATH的src目录 cd $GOPATH/src
2. 克隆主项目源码
接下来，将目标项目克隆到$GOPATH/src下对应的路径。例如，github.com/kr/godep应该位于$GOPATH/src/github.com/kr/godep。
# 在GOPATH/src下创建项目路径的父目录 mkdir -p github.com/kr/godep # 切换到项目路径的父目录 cd github.com/kr/godep/.. # 克隆项目源码 git clone https://github.com/kr/godep.git # 切换到项目目录 cd godep
3. 尝试构建并识别缺失依赖
现在，尝试在项目目录中执行go build。
go build
如果项目有未满足的依赖，go build会报错，提示找不到包，例如：
dep.go:4:2: cannot find package "code.google.com/p/go.tools/go/vcs" in any of: /usr/local/Cellar/go/1.2/libexec/src/pkg/code.google.com/p/go.tools/go/vcs (from $GOROOT) /Users/hanxue/Source/godep/godep/src/code.google.com/p/go.tools/go/vcs (from $GOPATH) save.go:5:2: cannot find package "github.com/kr/fs" in any of: /usr/local/Cellar/go/1.2/libexec/src/pkg/github.com/kr/fs (from $GOROOT) /Users/hanxue/Source/godep/godep/src/github.com/kr/fs (from $GOPATH)
这些错误信息明确指出了缺失的包及其导入路径。
4. 手动获取缺失依赖
对于每一个缺失的包，都需要手动将其源码克隆到$GOPATH/src下对应的路径。请注意，不同依赖可能使用不同的版本控制系统（VCS），如Git、Mercurial (hg) 或 Subversion (svn)。
示例1：获取code.google.com/p/go.tools
根据错误信息，我们需要code.google.com/p/go.tools/go/vcs。这表明完整的项目是code.google.com/p/go.tools。在Go 1.2时代，Google Code上的项目通常使用Mercurial。
# 切换回GOPATH的src目录 cd $GOPATH/src # 创建依赖的父目录 mkdir -p code.google.com/p/ # 切换到父目录 cd code.google.com/p # 使用hg克隆依赖项目 hg clone https://code.google.com/p/go.tools/
示例2：获取github.com/kr/fs
# 切换回GOPATH的src目录 cd $GOPATH/src # 创建依赖的父目录 mkdir -p github.com/kr/ # 切换到父目录 cd github.com/kr/ # 使用git克隆依赖项目 git clone https://github.com/kr/fs.git
重复这个过程，直到所有依赖都被正确放置在$GOPATH/src下的相应位置。每次添加依赖后，回到主项目目录再次尝试go build，以发现新的缺失依赖。
辅助技巧：利用go get下载项目依赖
虽然我们旨在避免对主项目使用go get，但一旦主项目被手动克隆到GOPATH中，可以在该项目目录下利用go get来自动下载其所有可获取的依赖项。这可以大大简化手动处理大量依赖的繁琐过程。
# 切换到主项目目录 cd $GOPATH/src/github.com/kr/godep # 在项目目录下执行go get . # 这会下载当前项目所需的所有依赖到GOPATH go get .
go get .命令会解析当前目录下的Go源文件，并自动下载所有缺失的导入包。如果某些依赖不可通过go get获取（例如私有仓库或需要特定认证的仓库），则仍需手动处理。
总结与注意事项
手动从源码构建Go项目，尤其是在早期Go版本中，需要对GOPATH和Go的包查找机制有深入的理解。这个过程虽然繁琐，但对于调试构建问题、处理特殊依赖或在受限网络环境下工作时非常有用。
- GOPATH配置至关重要： 确保GOPATH环境变量正确设置，并且所有项目和依赖都位于其src子目录下的正确路径。
- 尊重导入路径： 包的导入路径（如github.com/user/repo）决定了其在$GOPATH/src中的物理位置。
- 识别VCS类型： 不同的依赖可能使用Git、Mercurial或Subversion等不同的版本控制系统。在克隆时需使用对应的客户端工具。
- 迭代解决依赖： 依赖关系可能很深，需要多次尝试go build并逐一解决缺失的包。
- go get .的妙用： 在手动克隆主项目后，利用go get .可以自动处理大部分可获取的依赖，显著提高效率。
随着Go模块（Go Modules）的引入，Go项目的依赖管理变得更加现代化和便捷，但理解GOPATH时代的构建原理，对于解决特定场景下的构建问题仍然具有重要意义。