1. 理解Go工作区与GOPATH
在go语言的早期版本中，gopath是一个至关重要的环境变量，它定义了go工作区的根目录。所有go项目的源代码、编译后的包文件和可执行文件都默认存放在gopath指定的路径下。尽管go modules的引入降低了gopath在项目管理中的核心地位，但对于从本地源码手动安装第三方项目，特别是那些仍遵循传统gopath结构的项目时，正确设置和理解gopath依然是关键。
GOPATH的结构： 一个典型的GOPATH目录包含以下三个子目录：
- src：存放所有Go项目的源代码。每个项目或包都以其导入路径作为目录结构。
- pkg：存放编译后的包文件（.a文件），按操作系统和架构分类。
- bin：存放通过go install命令编译生成的可执行文件。
设置GOPATH环境变量： 首先，你需要选择一个目录作为你的Go工作区根目录，并确保其下包含一个src子目录。例如，在Windows系统上，你可以将其设置为E:\WORKSPACE_GO。
# Windows (命令提示符) set GOPATH=E:\WORKSPACE_GO # Windows (PowerShell) $env:GOPATH="E:\WORKSPACE_GO" # Linux/macOS export GOPATH=/path/to/your/workspace
请注意，为了使GOPATH永久生效，你需要将其添加到系统的环境变量中。
2. 构建正确的源码目录结构
当go install命令报告cannot find package错误时，这通常意味着Go编译器无法根据导入路径找到对应的源代码文件。解决此问题的核心在于，将下载的源码放置在GOPATH下的src目录中，并确保其路径结构与Go包的导入路径完全一致。
以mgo项目为例，其导入路径为launchpad.net/mgo。这意味着在GOPATH/src目录下，你需要创建一个与此导入路径对应的目录结构。
示例：mgo项目的目录结构
假设你的GOPATH设置为E:\WORKSPACE_GO，并且你已将mgo的源码下载到本地。正确的目录结构应该是：
E:\WORKSPACE_GO
└── src
└── launchpad.net
└── mgo
├── .bzr
├── bson
└── testdb
└── ... (mgo项目的其他文件和目录)操作步骤：
-
创建src目录： 如果你的GOPATH目录下没有src子目录，请先创建它。
mkdir E:\WORKSPACE_GO\src
-
创建包路径目录： 根据项目的导入路径，在src目录下逐级创建相应的目录。对于mgo，你需要创建launchpad.net和mgo目录。
mkdir E:\WORKSPACE_GO\src\launchpad.net\mgo
- 复制源码： 将你下载的mgo项目的所有源码文件和子目录（例如bson、testdb等）复制到E:\WORKSPACE_GO\src\launchpad.net\mgo目录下。
通过这种方式，当Go编译器尝试导入launchpad.net/mgo或launchpad.net/mgo/bson时，它就能在GOPATH/src下找到对应的源代码。
3. 执行安装：使用go install命令
go install命令用于编译并安装Go包。它会将编译后的包文件放入GOPATH/pkg目录，如果编译的是主包（package main），则会将生成的可执行文件放入GOPATH/bin目录。
安装步骤：
在安装具有内部依赖的第三方项目时，通常需要先安装其依赖包，然后再安装主包。以mgo为例，mgo项目依赖于其内部的bson包。
-
安装依赖包（如bson）： 首先，进入bson包的目录，然后执行go install。
cd E:\WORKSPACE_GO\src\launchpad.net\mgo\bson go install
如果一切顺利，此命令将编译bson包并将其安装到GOPATH/pkg目录下。
-
安装主项目（mgo）： 接下来，返回到mgo的主目录，并执行go install。
cd E:\WORKSPACE_GO\src\launchpad.net\mgo go install
此命令将编译mgo项目，并由于它是一个库而非可执行程序，其编译结果也将存放在GOPATH/pkg目录下。
如果这两个步骤都没有报错，则表示mgo项目及其依赖已成功安装。
4. 注意事项与最佳实践
- GOPATH的准确性： 确保GOPATH环境变量已正确设置，并且其指向的目录是你期望的工作区根目录。
- src目录的存在： GOPATH目录下必须有src子目录，所有源码都应放置在其内部。
- 包路径的严格匹配： 这是手动安装成功的关键。源码在文件系统中的路径必须与Go代码中定义的包导入路径（例如import "launchpad.net/mgo"）完全一致。
- 依赖顺序： 对于具有内部依赖的项目，通常需要先安装依赖包，再安装主包。go install会自动处理外部依赖，但对于手动放置的内部依赖，按顺序安装可以避免cannot find package错误。
- Go Modules项目： 如果你处理的是一个Go Modules项目，且该项目已经启用了Go Modules（即项目根目录有go.mod文件），那么go get或go build在GOPATH之外的任何目录都可以工作，并且会下载依赖到GOMODCACHE。但在本教程场景下，我们假设go get受阻，且项目可能仍依赖于GOPATH结构或需要手动管理。对于这类情况，将源码放置到GOPATH/src下并遵循上述步骤依然有效。
- 验证安装： 安装完成后，可以通过查看GOPATH/pkg目录来确认对应的.a文件是否存在。如果安装的是可执行文件，则可以在GOPATH/bin中找到。
总结
当标准的go get命令因各种原因无法使用时，手动从本地源码安装Go第三方项目是一种有效的替代方案。成功的关键在于正确配置GOPATH环境变量，并严格遵循Go包的目录结构规范，将源码放置在GOPATH/src下与包导入路径相匹配的子目录中。通过理解和应用这些步骤，即使面对网络障碍，也能确保Go项目的顺利编译和安装。
