1. 理解Go工作区与GOPATH
在go modules出现之前，gopath是go项目依赖管理的核心。它定义了go工作区（workspace）的根目录，所有go源码、编译后的包以及可执行文件都将存储在这个工作区内。即使在go modules盛行的今天，理解gopath对于处理一些老项目或特定场景依然至关重要。
1.1 GOPATH的结构
一个标准的GOPATH目录通常包含三个子目录：
- src：存放所有Go项目的源代码。
- pkg：存放编译后生成的包文件（.a文件）。
- bin：存放编译后生成的可执行文件。
1.2 设置GOPATH环境变量
首先，你需要设置GOPATH环境变量，指向你的Go工作区根目录。例如，如果你希望将工作区设置在E:\WORKSPACE_GO，则需要进行如下设置：
-
Windows:
set GOPATH=E:\WORKSPACE_GO
或者通过“系统属性” -> “高级” -> “环境变量”进行图形化设置。
-
Linux/macOS:
export GOPATH=/path/to/your/workspace_go
建议将此命令添加到~/.bashrc、~/.zshrc或~/.profile文件中，使其永久生效。
重要提示： GOPATH指向的目录必须包含一个src子目录。如果你的GOPATH是E:\WORKSPACE_GO，那么Go编译器期望的源码路径将从E:\WORKSPACE_GO\src开始查找。
2. 正确组织本地源码目录结构
这是手动安装Go项目最关键的一步。Go编译器通过包的导入路径来查找对应的源码文件。当你导入一个包，例如launchpad.net/mgo时，Go会期望在GOPATH/src/launchpad.net/mgo这个路径下找到该包的源码。因此，手动下载的源码必须严格按照其包导入路径的结构放置。
2.1 匹配包导入路径
假设你下载了mgo项目的源码，其在代码中定义的包路径是launchpad.net/mgo。那么，你需要将下载的mgo源码放置在%GOPATH%/src/launchpad.net/mgo目录下。
示例：以mgo项目为例
设置GOPATH： 假设你的GOPATH设置为E:\WORKSPACE_GO。
-
创建必要的目录结构： 首先，确保GOPATH下有src目录：E:\WORKSPACE_GO\src。 然后，根据包导入路径launchpad.net/mgo，创建子目录：
E:\WORKSPACE_GO\src\launchpad.net\mgo
你可以手动创建这些文件夹，或者使用命令行：
mkdir -p E:\WORKSPACE_GO\src\launchpad.net\mgo
（-p参数在Linux/macOS下可以创建多级目录，Windows下需要分步创建或使用mkdir多次）
-
复制源码： 将你手动下载的mgo项目的所有源码文件（包括bson子目录等）复制到E:\WORKSPACE_GO\src\launchpad.net\mgo这个最终目录下。
完成后的目录结构应类似：
E:\WORKSPACE_GO └── src └── launchpad.net └── mgo ├── .bzr (或其他版本控制目录，如果存在) ├── bson (mgo的子包) ├── testdb └── ... (其他mgo项目文件)
3. 执行本地安装
当源码目录结构正确无误后，就可以使用go install命令进行安装了。go install命令会编译指定包的源码，并将编译后的包文件（.a）放置到GOPATH/pkg目录下，如果该包是可执行文件（main包），则会将其可执行文件放置到GOPATH/bin目录下。
3.1 编译子包
如果项目包含子包（如mgo项目中的bson），通常建议先安装子包，再安装主包，以确保依赖关系正确解决。
-
安装bson子包： 导航到bson子包的目录，然后执行go install。
cd E:\WORKSPACE_GO\src\launchpad.net\mgo\bson go install
如果一切顺利，此命令将不会输出任何内容，并在GOPATH/pkg下生成bson包的编译结果。
-
安装mgo主包： 返回到mgo主包的目录，然后执行go install。
cd E:\WORKSPACE_GO\src\launchpad.net\mgo go install
同样，成功安装后不会有任何输出。
现在，mgo项目及其依赖的bson子包都已成功编译并安装到你的Go工作区中。其他Go项目就可以通过import "launchpad.net/mgo"来引用它了。
4. 注意事项与常见问题
- GOPATH的唯一性： 确保你的环境中只有一个GOPATH生效，或者在使用时明确指定。多个GOPATH路径会用冒号（Linux/macOS）或分号（Windows）分隔，但通常建议为一个项目或工作流设置一个主GOPATH。
- Go Modules模式下的差异： 本教程主要针对GOPATH模式。如果你的Go版本（1.11+）默认开启了Go Modules，且项目已启用Modules，那么依赖管理方式会有所不同。在Go Modules模式下，项目通常位于GOPATH之外，依赖会下载到GOPATH/pkg/mod或项目根目录下的vendor目录中。但对于无法通过go get获取的特定源码，上述手动组织GOPATH/src的方法依然是一种有效的“绕过”方案，尤其是在需要将源码视为本地包引入时。
-
错误信息解读：
- cannot find package "..."：最常见的问题是目录结构不匹配，Go编译器无法根据导入路径找到对应的源码文件。请仔细检查GOPATH和源码放置路径是否严格对应。
- no install location for _/E_/mgo/bson：这通常意味着你尝试在一个非标准包路径下执行go install，或者GOPATH没有正确设置。确保你是在GOPATH/src下的正确包路径中执行go install。
总结
通过本教程，你已经掌握了在go get命令失效时，手动下载Go第三方项目源码并进行本地安装的方法。核心在于正确设置GOPATH环境变量，并严格按照Go包的导入路径规则组织本地源码目录结构。遵循这些步骤，即使面对复杂的网络环境或特定的项目依赖，也能有效地管理你的Go项目。在现代Go开发中，虽然Go Modules已成为主流，但理解GOPATH的工作原理对于解决特定场景下的问题依然具有重要价值。
