Linux系统下设置Golang环境变量的永久生效方法-Golang-PHP中文网

Linux系统下设置Golang环境变量的永久生效方法

P粉602998670

发布： 2025-09-02 08:48:01

原创

762人浏览过

将Go环境变量写入Shell配置文件（如~/.bashrc或~/.profile）可使其永久生效，因为这些文件在每次启动终端时自动加载，避免了仅用export导致的临时性问题。

linux系统下设置golang环境变量的永久生效方法

要在Linux系统下让Golang的环境变量永久生效，最直接有效的方法就是将它们写入到你的Shell配置文件中，比如用户主目录下的

.bashrc

登录后复制

或

.profile

登录后复制

文件。这样，每次你启动新的终端会话时，这些变量都会被自动加载。

说实话，刚开始接触Linux和Go的时候，环境变量这事儿确实把我折腾得够呛。你可能也遇到过，明明

export

登录后复制

了，终端一关就没了，那种感觉真是让人抓狂。要彻底搞定它，我们需要找一个Shell启动时会执行的脚本文件。

对我个人而言，最常用的就是用户主目录下的

.bashrc

登录后复制

文件。它在每次交互式Bash Shell启动时都会被执行。如果你希望这些变量对当前用户的所有Shell都生效，包括非交互式的Shell，那么

.profile

登录后复制

或者

.bash_profile

登录后复制

可能是更好的选择。不过，对于大多数日常开发场景，

.bashrc

登录后复制

就足够了，而且很多发行版默认的

.bashrc

登录后复制

会去source

.profile

登录后复制

。

具体操作步骤其实很简单：

立即学习“go语言免费学习笔记（深入）”；

打开你的Shell配置文件： 我通常用
```
vi
```
登录后复制
或
```
nano
```
登录后复制
来编辑。比如，编辑
```
.bashrc
```
登录后复制
：
```
nano ~/.bashrc
```
登录后复制
添加Go相关的环境变量： 在文件的末尾，添加以下几行。这里假设你的Go安装在
```
/usr/local/go
```
登录后复制
，并且你的项目工作区在
```
~/go
```
登录后复制
。如果你的路径不同，请务必修改。
```
# Go Lang Environment Setup
export GOROOT=/usr/local/go
export GOPATH=$HOME/go
export PATH=$PATH:$GOROOT/bin:$GOPATH/bin
```
登录后复制
这里我得稍微解释一下：
- ```
GOROOT
```
  登录后复制
  指向的是你的Go SDK的安装路径。这是Go运行时必需的。
- ```
GOPATH
```
  登录后复制
  是你的Go工作区。Go模块化之后，
```
GOPATH
```
  登录后复制
  的重要性有所下降，但它仍然是存放传统项目、第三方包（在Go Modules出现之前）以及
```
go install
```
  登录后复制
  编译生成的可执行文件的默认位置。我通常会把它设置在
```
$HOME/go
```
  登录后复制
  ，这样很直观。
- ```
PATH
```
  登录后复制
  这个就不用多说了，它告诉系统去哪里找可执行文件。我们把
```
$GOROOT/bin
```
  登录后复制
  和
```
$GOPATH/bin
```
  登录后复制
  加进去，这样你就能直接在任何地方运行
```
go
```
  登录后复制
  命令以及你自己编译的Go程序了。
保存并退出文件。
让配置立即生效： 虽然下次打开新终端会话时会生效，但为了立即使用，你需要手动执行一下
```
source
```
登录后复制
命令：
```
source ~/.bashrc
```
登录后复制
或者如果你修改的是
```
.profile
```
登录后复制
，那就
```
source ~/.profile
```
登录后复制
。

这样一来，你的Go环境变量就永久生效了。每次开机或者打开新的终端，Go的环境就都在那里等着你。

为什么我明明设置了环境变量，重启终端就没了？

这其实是个很经典的“坑”。你直接在终端里用

export

登录后复制

命令设置的环境变量，它只对当前Shell会话有效。你可以把它想象成一个临时的便签，只在这次会话里有用。一旦这个Shell进程结束了（比如你关掉了终端窗口），这个便签就被撕掉了，所有的临时设置也就跟着烟消云散了。

Linux系统在启动Shell会话时，会去读取一些特定的配置文件来初始化环境。这些文件，比如我们前面提到的

.bashrc

登录后复制

、

.profile

登录后复制

、

/etc/profile

登录后复制

等等，才是真正用来存放永久性配置的地方。当你把

export

登录后复制

命令写进这些文件里，就相当于把你的环境变量设置写进了系统的“长期记忆”里。每次Shell启动，它都会重新阅读这些文件，然后根据里面的指示来设置环境变量，所以它们就能“活”下来了。

理解这个原理，你就会明白为什么我们不能仅仅依靠

export

登录后复制

命令来做永久设置了。这也不是Go特有的问题，任何你想要永久生效的环境变量，都需要通过这种方式来处理。

落笔AI

AI写作，AI写网文、AI写长篇小说、短篇小说

查看详情

如何快速验证我的Go环境变量是否已经设置成功？

设置完环境变量后，你肯定想知道到底有没有生效。验证的方法其实非常简单直接，几条命令就能搞定。

首先，确保你已经

source

登录后复制

了你的配置文件，或者直接打开一个新的终端窗口。

检查
```
GOROOT
```
登录后复制
：
```
echo $GOROOT
```
登录后复制
如果输出的是你Go SDK的安装路径（例如
```
/usr/local/go
```
登录后复制
），那就对了。
检查
```
GOPATH
```
登录后复制
：
```
echo $GOPATH
```
登录后复制
这里应该显示你设置的工作区路径（例如
```
/home/youruser/go
```
登录后复制
）。
检查
```
PATH
```
登录后复制
：
```
echo $PATH
```
登录后复制
这个输出会比较长，因为它包含了系统所有可执行文件的路径。你需要仔细查看，确认其中是否包含了
```
$GOROOT/bin
```
登录后复制
和
```
$GOPATH/bin
```
登录后复制
这两个路径。通常它们会出现在你设置的位置。
运行
```
go env
```
登录后复制
命令： 这是Go官方提供的环境检查工具，非常全面。
```
go env
```
登录后复制
这条命令会列出所有Go相关的环境变量，包括
```
GOROOT
```
登录后复制
、
```
GOPATH
```
登录后复制
、
```
GOBIN
```
登录后复制
（如果设置了）、
```
GOOS
```
登录后复制
、
```
GOARCH
```
登录后复制
等等。你可以对照着看，确保
```
GOROOT
```
登录后复制
和
```
GOPATH
```
登录后复制
的值和你预期的一致。如果一切正常，
```
go env
```
登录后复制
的输出会给你一个清晰的确认。

如果这些命令的输出和你预期不符，那说明可能哪里出了问题。常见的错误包括：文件没保存、

source

登录后复制

命令没执行、或者环境变量路径写错了。这时候就需要回去检查你的配置文件了。

针对所有用户还是仅针对当前用户？环境变量设置位置的选择考量

在Linux系统上设置环境变量，你总会面临一个选择：是让这些设置只对你当前用户生效，还是对系统上的所有用户都生效？这取决于你的具体需求和使用场景。

用户级环境变量 (User-specific): 这是最常见也最推荐的方式，通常通过修改用户主目录下的配置文件来实现，比如：

```
~/.bashrc
```
登录后复制
：仅对交互式Bash Shell会话生效。
```
~/.profile
```
登录后复制
或
```
~/.bash_profile
```
登录后复制
：在用户登录时执行，影响所有Shell会话（包括非交互式）。
```
~/.zshrc
```
登录后复制
：如果你使用的是Zsh，那么就是这个文件。

优点：