针对go项目在travis ci上进行测试时，因绝对路径导入导致包查找失败的问题，本教程提供了一种基于符号链接的解决方案。通过在travis ci构建环境中，将项目实际构建目录链接到go工作区预期的绝对导入路径，可以确保测试顺利运行并正确计算代码覆盖率。
在Go语言项目中，使用绝对路径进行包导入是推荐的最佳实践，例如 import "github.com/your_user/your_repo/your_package"。这种方式清晰地指明了包的来源，并有助于避免命名冲突。然而，当项目集成到持续集成（CI）平台如Travis CI时，这种导入方式可能会导致问题。
问题分析
Travis CI在执行构建任务时，会将项目仓库克隆到一个临时目录，通常是 $TRAVIS_BUILD_DIR。默认情况下，这个目录并不在Go语言的 $GOPATH/src 结构之下。当Go编译器或测试工具尝试解析 github.com/your_user/your_repo/your_package 这样的绝对导入路径时，它会在 $GOROOT 和 $GOPATH/src 中查找对应的目录。由于项目实际代码位于 $TRAVIS_BUILD_DIR，而不在 $GOPATH/src/github.com/your_user/your_repo，Go工具链便无法找到所需的包，从而报告“cannot find package”错误。
例如，当测试代码中包含如下导入：
package user_test
import (
. "github.com/NeilGarb/budget/core"
)Travis CI可能会输出类似以下错误：
can't load package: package github.com/NeilGarb/budget/core: cannot find package "github.com/NeilGarb/budget/core" in any of: /home/travis/.gvm/gos/go1.2/src/pkg/github.com/NeilGarb/budget/core (from $GOROOT) /home/travis/.gvm/pkgsets/go1.2/global/src/github.com/NeilGarb/budget/core (from $GOPATH)
尽管使用相对导入（如 import "../core"）可以在本地或某些CI环境中暂时解决编译问题，但这种方法通常会导致代码覆盖率工具无法正确识别和报告覆盖率，因为它改变了包的识别路径。
解决方案：创建符号链接
解决此问题的有效方法是在Travis CI的构建环境中，手动创建一个符号链接（symlink）。这个符号链接将 $GOPATH/src/github.com/your_user/your_repo 指向 $TRAVIS_BUILD_DIR，从而模拟出Go工具链期望的项目结构。
具体步骤是在 .travis.yml 配置文件中，在执行任何Go命令（如 go test）之前，添加 before_install 阶段来创建必要的目录结构和符号链接。
以下是一个示例 .travis.yml 配置：
language: go go: - 1.x # 或者指定具体的Go版本，例如 1.16, 1.17 before_install: # 1. 创建Go工作区中存放项目的上级目录 # 假设你的项目是 github.com/NeilGarb/budget # 那么需要创建 $GOPATH/src/github.com/NeilGarb - mkdir -p $GOPATH/src/github.com/NeilGarb # 2. 创建符号链接，将Go工作区中预期的项目路径链接到实际的构建目录 # $TRAVIS_BUILD_DIR 是Travis CI克隆项目到的实际路径 - ln -s $TRAVIS_BUILD_DIR $GOPATH/src/github.com/NeilGarb/budget script: # 运行测试，Go工具链现在可以正确解析绝对导入路径了 - go test -v ./... # 如果使用Ginkgo等测试框架，可能需要先安装 # - go get github.com/onsi/ginkgo/ginkgo # - ginkgo -r -v github.com/NeilGarb/budget/core
代码解释：
- language: go 和 go: - 1.x：指定项目使用Go语言，并选择Go版本。
- before_install:：这是一个Travis CI的生命周期钩子，在此阶段执行的命令会在安装依赖之前运行。
- mkdir -p $GOPATH/src/github.com/NeilGarb：这条命令会创建 github.com/NeilGarb 目录（如果不存在），确保符号链接的目标路径的上级目录存在。你需要根据自己的项目仓库路径（例如 github.com/your_username）进行调整。
- ln -s $TRAVIS_BUILD_DIR $GOPATH/src/github.com/NeilGarb/budget：这是核心命令。
- ln -s：用于创建符号链接。
- $TRAVIS_BUILD_DIR：这是符号链接的源，即项目代码实际所在的目录。
- $GOPATH/src/github.com/NeilGarb/budget：这是符号链接的目标，即Go工具链期望项目代码所在的路径。通过这个链接，Go工具链会认为项目代码就在 $GOPATH 下，从而成功解析绝对导入。
- script:：在此阶段执行项目的测试或构建命令。由于符号链接已建立，go test 等命令将能正常工作。
注意事项
- 路径适配： 务必将示例中的 github.com/NeilGarb/budget 替换为你的实际项目仓库路径。例如，如果你的项目是 gitlab.com/myuser/myproject，则 mkdir 命令应为 mkdir -p $GOPATH/src/gitlab.com/myuser，ln -s 命令应为 ln -s $TRAVIS_BUILD_DIR $GOPATH/src/gitlab.com/myuser/myproject。
- Go Modules： 对于使用Go Modules（Go 1.11及更高版本）的项目，Go Modules通常会将依赖下载到模块缓存中，并直接在 $TRAVIS_BUILD_DIR 中构建项目，很多情况下可以避免此类 $GOPATH 相关的问题。但如果你的项目仍然部分依赖 $GOPATH 行为，或者在某些特定场景下遇到导入问题，此符号链接方法依然有效。
- CI环境变量： Travis CI通常会正确设置 GOPATH 和 TRAVIS_BUILD_DIR 等环境变量，因此无需手动设置。
总结
通过在Travis CI的 before_install 阶段巧妙地利用符号链接，我们可以有效地解决Go项目在持续集成环境中因绝对路径导入而导致的包查找失败问题。这种方法不仅确保了测试的顺利执行，还维护了代码覆盖率报告的准确性，从而保证了项目的持续集成流程的顺畅和代码质量的可靠性。
