Golang macOS Homebrew安装配置详细教程

首先运行brew install go安装Go，再设置GOPATH和PATH环境变量，最后验证安装并运行测试程序，即可完成macOS上Go的配置。

在macOS上通过Homebrew安装和配置Golang，核心就是运行

brew install go

解决方案

首先，确保你的macOS系统上已经安装了Homebrew。如果还没有，打开终端，执行以下命令：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装Homebrew后，就可以开始安装Go了。在终端中输入：

brew install go

Homebrew会为你下载并安装最新稳定版的Go。安装完成后，你可以通过运行

go version

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

接下来是环境变量的配置，这部分至关重要。虽然Go Modules的出现让GOPATH的重要性有所下降，但它仍然是Go生态系统不可或缺的一部分，尤其是对于工具链和缓存。

1. 设置GOPATH： 通常，我会将GOPATH设置为用户目录下的一个

   go

   文件夹，比如

   ~/go

   。这个目录会存放你的Go模块缓存、下载的第三方包以及一些通过

   go install

   安装的二进制文件。

   echo 'export GOPATH=$HOME/go' >> ~/.zshrc # 如果你用的是zsh
   # 或者 echo 'export GOPATH=$HOME/go' >> ~/.bash_profile # 如果你用的是bash

2. 将GOPATH/bin添加到PATH： 为了让系统能够找到通过

   go install

   命令编译生成的二进制文件，你需要将

   $GOPATH/bin

   添加到系统的PATH环境变量中。

   echo 'export PATH=$PATH:$GOPATH/bin' >> ~/.zshrc # 同样，根据你的shell选择
   # 或者 echo 'export PATH=$PATH:$GOPATH/bin' >> ~/.bash_profile

3. 刷新环境变量： 修改完配置文件后，需要让终端重新加载这些配置，才能使它们生效。

   source ~/.zshrc # 或者 source ~/.bash_profile

现在，你可以尝试创建一个简单的Go程序来测试你的配置。新建一个文件

hello.go

package main

import "fmt"

func main() {
    fmt.Println("Hello, Go on macOS with Homebrew!")
}

然后在终端中导航到

hello.go

go run hello.go

如果一切顺利，你会在终端看到输出

Hello, Go on macOS with Homebrew!

Homebrew安装Go和官方包安装有什么区别？我应该选择哪种方式？

我个人在macOS上安装Go时，几乎总是倾向于使用Homebrew。这两种安装方式各有优劣，但对于大多数开发者而言，Homebrew的便利性是无与伦比的。

Homebrew安装Go：

• 优点：
  • 管理便捷： Homebrew就像你的macOS应用商店，一条命令

    brew install go

    就能搞定安装，

    brew upgrade go

    就能轻松升级，甚至可以方便地切换Go版本（虽然切换版本不常用，但有总比没有好）。
  • 集成度高： 它能很好地融入macOS的生态系统，处理依赖关系也更省心。
  • 路径清晰： 通常会将Go安装在

    /usr/local/Cellar/go/

    下，并通过软链接到

    /usr/local/opt/go

    和

    /usr/local/bin/go

    ，路径管理非常清晰。
• 缺点：
  • 版本更新： Homebrew上的Go版本可能不会在Google官方发布新版本后立即同步，但通常延迟很小，几乎可以忽略不计。

官方包（.pkg文件）安装Go：

• 优点：
  • 最新版本： 你总是能第一时间从Go官网下载到最新、最原汁原味的Go版本。
  • 安装路径固定： 默认安装在

    /usr/local/go

    ，路径明确。
• 缺点：
  • 手动更新： 每次Go版本更新，你都需要手动下载新的.pkg文件并重新安装，这比较繁琐。
  • 版本管理： 没有Homebrew那样方便的版本切换机制。
  • 路径配置： 虽然安装器会尝试配置PATH，但有时可能需要你手动检查和调整。

我的建议：

如果你不是那种非要第一时间体验Go的每日构建版本，或者对版本控制有极度特殊要求的开发者，那么Homebrew绝对是你的首选。它极大地简化了安装、升级和管理Go的流程，让你能把更多精力放在代码上，而不是环境配置上。我个人觉得，那种“一键搞定”的体验，真的能省下不少心力。

《PHP程序设计》第二版

本书图文并茂，详细讲解了使用LAMP（PHP）脚本语言开发动态Web程序的方法，如架设WAMP平台，安装与配置开源Moodle平台，PHP程序设计技术，开发用户注册与验证模块，架设LAMP平台。　本书适合计算机及其相关专业本、专科学生作为学习LAMP（PHP）程序设计或动态Web编程的教材使用，也适合对动态Web编程感兴趣的读者自觉使用，对LAMP（PHP）程序设计人员也具有一定的参考价值。

下载

Golang环境变量GOPATH和PATH到底怎么设置才对？有什么需要注意的坑吗？

GOPATH和PATH这两个环境变量，对于初学者来说确实是个容易混淆的地方，我记得我刚开始接触Go的时候也在这上面踩过不少坑。但其实，只要理解它们各自的职责，就会发现它们并没有那么复杂。

GOPATH：

• 历史作用： 在Go Modules（Go 1.11引入，1.13默认开启）之前，GOPATH是至关重要的。它不仅指定了你的Go项目代码存放的位置，也是Go查找第三方依赖包的唯一路径。所有项目都必须放在GOPATH下的

  src

  目录里。
• 现代作用（Go Modules时代）： 随着Go Modules的普及，你的项目代码不再需要强制放在GOPATH下。你的项目可以放在文件系统的任何位置。然而，GOPATH并没有完全“退休”。它现在主要扮演以下角色：
  • 二进制文件存放地： 通过

    go install

    命令编译安装的二进制可执行文件，默认会存放在

    $GOPATH/bin

    目录下。
  • 模块缓存： Go Modules下载的依赖包的源代码会缓存到

    $GOPATH/pkg/mod

    目录中。
  • 构建缓存： Go的构建缓存也存放在GOPATH下。
• 如何设置： 我建议将其设置为一个独立且易于管理的目录，例如

  $HOME/go

  。
• 注意的坑：
  • 不要将GOPATH设置为你的项目目录！ 这是最常见的错误之一。GOPATH应该是一个独立的、全局的Go工作区，而不是某个具体的项目。
  • 理解其角色变化： 很多人以为有了Go Modules，GOPATH就完全没用了，然后就不设置或者随意设置，导致一些工具或命令找不到路径。它只是从“代码存放地”变成了“工具和缓存存放地”。

PATH：

• 作用： PATH是操作系统用来查找可执行程序的目录列表。当你输入一个命令（比如

  go

  或你用Go编译的程序名）时，系统会按顺序在PATH环境变量列出的所有目录中查找这个命令对应的可执行文件。
• 如何设置： 关键是将Go的安装路径（Homebrew通常会自动处理）以及

  $GOPATH/bin

  添加到PATH中。
  • Go的安装路径：Homebrew通常会把Go的可执行文件软链接到

    /usr/local/bin

    ，而这个目录一般已经在你的PATH里了。

  • $GOPATH/bin

    ：这个目录需要你手动添加到PATH，这样你通过

    go install

    安装的各种Go工具或你自己的Go程序才能直接在终端中运行。
• 注意的坑：
  • 没有

    source

    你的配置文件： 修改了

    .zshrc

    或

    .bash_profile

    后，如果没有运行

    source ~/.zshrc

    （或对应文件），新的环境变量是不会生效的。每次打开新终端时，这些配置才会自动加载。
  • 编辑了错误的配置文件： macOS默认使用zsh，所以你应该编辑

    ~/.zshrc

    。如果你还在用bash，那就是

    ~/.bash_profile

    。有时用户会混淆。
  • PATH顺序问题： 确保

    $GOPATH/bin

    在PATH中，并且通常放在现有PATH的末尾，避免覆盖系统自带的命令。

要验证你的GOPATH和PATH是否设置正确，可以在终端中分别运行

echo $GOPATH

echo $PATH

which go

go

Go Modules在macOS上如何配合Homebrew安装的Go使用？我还需要关心GOPATH吗？

Go Modules是Go语言官方推荐的依赖管理方式，它彻底改变了Go项目管理依赖的方式，让项目可以脱离GOPATH的束缚，在文件系统的任何位置都能进行开发。在macOS上配合Homebrew安装的Go使用Go Modules，体验和任何其他Go安装方式都是一致的，非常顺畅。

Go Modules概览：

• 诞生背景： 解决了GOPATH时代版本冲突、依赖管理混乱等问题。
• 核心文件： 每个使用Go Modules的项目根目录会有一个

  go.mod

  文件，它记录了项目的模块路径、Go版本以及所有直接和间接依赖。

  go.sum

  文件则记录了所有依赖包的哈希值，用于验证依赖的完整性和安全性。
• 工作方式： 当你运行

  go build

  、

  go run

  或

  go test

  等命令时，Go会自动根据

  go.mod

  文件下载、管理和使用项目所需的依赖。

与Homebrew安装的Go配合使用：

Homebrew安装的Go版本（Go 1.13及以上）默认已经启用了Go Modules。所以，你不需要做任何额外的配置来“启用”它。

1. 初始化一个新模块： 在一个新的项目目录中，运行

   go mod init 

   。
   通常是你的代码仓库地址，例如

   github.com/yourusername/yourproject

   。这会生成

   go.mod

   文件。

   mkdir my-module-project
   cd my-module-project
   go mod init github.com/my/mymodule # 示例模块路径

2. 添加依赖： 当你在代码中

   import

   一个外部包时，Go Modules会自动检测到。你运行

   go build

   或

   go run

   时，Go会自动下载这些依赖并更新

   go.mod

   和

   go.sum

   。你也可以手动添加：

   go get github.com/gin-gonic/gin # 示例：添加Gin框架作为依赖

3. 清理依赖： 如果你的代码中不再使用某个依赖，可以运行

   go mod tidy

   来移除

   go.mod

   中不再需要的依赖项。

我还需要关心GOPATH吗？

这是一个非常好的问题，也是很多Go开发者容易产生误解的地方。答案是：是的，你仍然需要关心GOPATH！

尽管Go Modules让你的项目代码可以脱离GOPATH，但GOPATH在Go生态系统中依然扮演着重要的角色：

• 工具链的安装位置： 当你使用

  go install

  命令安装一些Go工具（比如

  golang.org/x/tools/gopls

  ，Go语言服务器）时，这些工具的二进制文件默认会被安装到

  $GOPATH/bin

  目录下。如果你的PATH中没有包含

  $GOPATH/bin

  ，那么这些工具将无法直接在终端中运行。
• 模块缓存和构建缓存： Go Modules下载的依赖包的源代码（实际是缓存）和Go的构建缓存，都存放在GOPATH下的特定目录中（

  $GOPATH/pkg/mod

  和

  $GOPATH/pkg/mod/cache

  ）。这些缓存对于Go的快速编译和高效工作至关重要。

所以，我的建议是：即使你主要使用Go Modules进行项目开发，也务必正确设置你的GOPATH，并确保

$GOPATH/bin