49、macOS 和 Windows 环境开发工具安装指南

macOS与Windows开发工具安装指南

最新推荐文章于 2025-09-24 19:48:09 发布

脸先着地天使

最新推荐文章于 2025-09-24 19:48:09 发布

阅读量35

点赞数

CC 4.0 BY-SA版权

分类专栏： Spring Boot 3与微服务架构实战文章标签： macOS Windows 开发工具安装

本文链接：https://blog.youkuaiyun.com/jwt8token/article/details/150363329

Spring Boot 3与微服务架构实战专栏收录该内容

53 篇文章 ¥499.90

订阅专栏¥69.90

会员秒杀 ¥9.9 重磅福利

超级会员免费看

macOS 和 Windows 环境开发工具安装指南

1. macOS 环境安装指南

1.1 技术要求

所有操作命令是在运行 macOS Ventura 的 MacBook Pro 上使用 bash 命令行运行的，且这些命令已在基于 Intel 和 Apple silicon 的 MacBook Pro 上验证。若使用其他 shell（如 zsh），建议在运行命令前切换到 bash：

/bin/bash

1.2 安装工具

需要安装的工具及对应下载安装信息链接如下：
| 工具 | 版本 | 下载安装链接 |
| ---- | ---- | ---- |
| Git | v2.37.1 | https://git-scm.com/downloads |
| Docker Desktop for Mac | v4.12.0 | https://hub.docker.com/editions/community/docker-ce-desktop-mac/ |
| Java | v17.0.6 | https://adoptium.net/installation |
| curl | v7.86.0 | https://curl.haxx.se/download.html |
| jq | v1.6 | https://stedolan.github.io/jq/download/ |
| Spring Boot CLI | v3.0.4 | https://docs.spring.io/spring-boot/docs/3.0.4/reference/html/getting-started.html#getting-started.installing.cli |
| Siege | v4.1.6 | https://github.com/JoeDog/siege#where-is-it |
| Helm | v3.11.1 | https://helm.sh/docs/intro/install/ |
| kubectl | v1.26.1 | https://kubernetes.io/docs/tasks/tools/install-kubectl-macos/ |
| Minikube | v1.29.0 | https://minikube.sigs.k8s.io/docs/start/ |
| Istioctl | v1.17.0 | https://istio.io/latest/docs/setup/getting-started/#download |

大部分工具将使用 Homebrew 包管理器（https://brew.sh/）安装，所以先安装 Homebrew：

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

验证 Homebrew 安装：

brew --version

使用 Homebrew 安装部分工具：

brew tap spring-io/tap && \
brew tap homebrew/cask-versions && \ 
brew install --cask temurin17 && \
brew install jq && \
brew install spring-boot && \
brew install helm && \
brew install siege && \
brew install --cask docker

对于 minikube、kubectl 和 istioctl，为更好控制安装版本，不使用 Homebrew 安装，不同芯片的 Mac 安装命令不同：

1.2.1 Intel 芯片 Mac

# 安装 kubectl
curl -LO "https://dl.k8s.io/release/v1.26.1/bin/darwin/amd64/kubectl"
sudo install kubectl /usr/local/bin/kubectl
rm kubectl

# 安装 minikube
curl -LO https://storage.googleapis.com/minikube/releases/v1.29.0/minikube-darwin-amd64
sudo install minikube-darwin-amd64 /usr/local/bin/minikube
rm minikube-darwin-amd64

# 安装 istioctl
curl -L https://istio.io/downloadIstio | ISTIO_VERSION=1.17.0 TARGET_ARCH=x86_64 sh -
sudo install istio-1.17.0/bin/istioctl /usr/local/bin/istioctl
rm -r istio-1.17.0

1.2.2 Apple silicon 芯片 Mac

# 安装 kubectl
curl -LO "https://dl.k8s.io/release/v1.26.1/bin/darwin/arm64/kubectl"
sudo install kubectl /usr/local/bin/kubectl
rm kubectl

# 安装 minikube
curl -LO https://storage.googleapis.com/minikube/releases/v1.29.0/minikube-darwin-arm64
sudo install minikube-darwin-arm64 /usr/local/bin/minikube
rm minikube-darwin-arm64

# 安装 istioctl
curl -L https://istio.io/downloadIstio | ISTIO_VERSION=1.17.0 TARGET_ARCH=arm64 sh -
sudo install istio-1.17.0/bin/istioctl /usr/local/bin/istioctl
rm -r istio-1.17.0

1.3 安装后操作

1.3.1 Java

在登录脚本中添加设置 JAVA_HOME 环境变量的命令：

echo 'export JAVA_HOME=$(/usr/libexec/java_home -v17)' >> ~/.bash_profile 
source ~/.bash_profile

1.3.2 Docker

建议配置 Docker，使其使用大部分 CPU（除少数）和 10GB 内存（若可用）。配置前确保 Docker 守护进程运行，可像启动其他 Mac 应用一样启动 Docker。
配置 Docker：点击状态栏 Docker 图标，选择 Preferences…，进入 Resources 选项卡设置 CPU 和内存，点击 Apply & Restart 完成配置。若不想每次开机手动启动 Docker，可在 General 选项卡选择 Start Docker Desktop when you log in。

1.4 验证安装

运行以下命令验证工具安装：

git version && \
docker version -f json | jq -r .Client.Version && \
java -version 2>&1 | grep "openjdk version" && \
curl --version | grep "curl" | sed 's/(.*//' && \
jq --version && \
spring --version && \
siege --version 2>&1 | grep SIEGE && \
helm version --short && \
kubectl version --client -o json | jq -r .clientVersion.gitVersion && \
minikube version | grep "minikube" && \
istioctl version --remote=false

1.5 获取源代码

源代码位于 GitHub 仓库：https://github.com/PacktPublishing/Microservices-with-Spring-Boot-and-Spring-Cloud-Third-Edition。
下载源代码到文件夹并设置环境变量：

export BOOK_HOME=~/Documents/Microservices-with-Spring-Boot-and-Spring-Cloud-Third-Edition 
git clone https://github.com/PacktPublishing/Microservices-with-Spring-Boot-and-Spring-Cloud-Third-Edition.git $BOOK_HOME

1.6 代码结构

每个章节包含多个 Java 项目，以第 14 章为例，项目结构如下：

├── api
├── microservices
│   ├── product-composite-service
│   ├── product-service
│   ├── recommendation-service
│   └── review-service
├── spring-cloud
│   ├── authorization-server
│   ├── config-server
│   ├── eureka-server
│   └── gateway
└── util

所有项目使用 Gradle 构建，文件结构遵循 Gradle 标准约定：

├── build.gradle
├── settings.gradle
└── src
    ├── main
    │   ├── java
    │   └── resources
    └── test
        ├── java
        └── resources

2. Windows 环境安装指南

2.1 技术要求

开发环境基于 Windows Subsystem for Linux v2（WSL 2），需要 Windows 10 版本 2004（build 19041）或更高版本。使用 WSL 2 运行基于 Ubuntu 22.04 的 Linux 服务器，所有命令使用 bash 运行。

2.2 安装工具

2.2.1 Windows 上安装的工具

工具	版本	下载安装链接
Windows Subsystem for Linux v2 (WSL 2)	-	https://docs.microsoft.com/en-us/windows/wsl/install-win10
Ubuntu 22.04 in WSL 2	-	https://apps.microsoft.com/store/detail/ubuntu-22042-lts/9PN20MSR04DW
Windows Terminal	v1.16.10261.0	https://www.microsoft.com/en-us/p/windows-terminal/9n0dx20hk701
Docker Desktop for Windows	v4.14.0	https://hub.docker.com/editions/community/docker-ce-desktop-windows/
Visual Studio Code and its extension for Remote WSL	v1.75.1	https://code.visualstudio.com 和 https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-wsl

2.2.2 Linux 服务器上安装的工具

工具	版本	下载安装链接
Git	v2.34.1	https://git-scm.com/downloads
Java	v17.0.6	https://adoptium.net/installation
curl	v7.81.0	https://curl.haxx.se/download.html
jq	v1.6	https://stedolan.github.io/jq/download/
Spring Boot CLI	v3.0.4	https://docs.spring.io/spring-boot/docs/3.0.4/reference/html/getting-started.html#getting-started.installing.cli
Siege	v4.0.7	https://github.com/JoeDog/siege#where-is-it
Helm	v3.11.2	https://helm.sh/docs/intro/install/#from-apt-debianubuntu
kubectl	v1.26.1	https://kubernetes.io/docs/tasks/tools/install-kubectl-linux/
minikube	v 1.29.1	https://minikube.sigs.k8s.io/docs/start/
istioctl	v1.17.0	https://istio.io/latest/docs/setup/getting-started/#download

2.3 安装步骤

2.3.1 Windows 上安装工具

安装 WSL 2 和默认 Ubuntu 服务器
1. 以管理员身份打开 PowerShell，运行 wsl –install 。
2. 重启电脑完成安装。
3. 重启后，Ubuntu 服务器将在新终端窗口自动安装，之后需输入用户名和密码。
4. 安装完成后，使用 lsb_release -d 验证 Ubuntu 版本。
安装新的 Ubuntu 22.04 服务器
1. 从 Microsoft Store 下载安装文件，可访问 https://aka.ms/wslstore 选择可用 Linux 发行版，或直接访问 https://apps.microsoft.com/store/detail/ubuntu-22042-lts/9PN20MSR04DW 下载 Ubuntu 22.04。
2. 下载后执行安装文件安装 Ubuntu 20.04。
3. 打开控制台窗口，片刻后需输入 Linux 服务器的用户名和密码。
安装 Windows Terminal
建议安装 Windows Terminal 简化对 Linux 服务器的访问，它支持多标签、多面板、多种 shell 等。可从 Microsoft Store 安装（https://aka.ms/terminal），启动后点击菜单箭头，选择 Ubuntu-22.04 启动 bash shell。

2.4 总结

通过以上步骤，可在 macOS 和 Windows 环境安装开发所需工具并获取源代码。在 macOS 环境使用 Homebrew 安装大部分工具，对部分工具手动控制版本安装；在 Windows 环境使用 WSL 2 运行 Ubuntu 服务器并安装工具。

2.5 后续操作

2.5.1 配置 Docker Desktop for Windows

安装完成 Docker Desktop for Windows 后，需要进行一些配置，以确保其能正常工作并满足开发需求。
1. 启动 Docker Desktop for Windows，可通过开始菜单或搜索栏找到并启动。
2. 启动后，点击系统托盘中的 Docker 图标，选择 “Settings” 进入设置界面。
3. 在设置界面中，选择 “Resources” 选项卡，对 CPU、内存和磁盘空间进行配置。建议分配足够的资源，例如将 CPU 分配为大部分（除少数），内存分配为 10GB（若可用），以确保能流畅运行多个容器和微服务。
4. 若希望 Docker 在系统启动时自动启动，可在 “General” 选项卡中勾选 “Start Docker Desktop when you log in”。
5. 完成配置后，点击 “Apply & Restart” 使设置生效。

2.5.2 在 Linux 服务器上安装工具

在完成 Windows 上的工具安装后，接下来需要在基于 Ubuntu 22.04 的 Linux 服务器上安装剩余工具。
1. 安装 Git

sudo apt-get update
sudo apt-get install git

安装 Java

sudo apt-get install -y openjdk-17-jdk

设置 JAVA_HOME 环境变量：

echo 'export JAVA_HOME=$(readlink -f /usr/bin/java | sed "s:bin/java::")' >> ~/.bashrc
source ~/.bashrc

安装 curl

sudo apt-get install curl

安装 jq

sudo apt-get install jq

安装 Spring Boot CLI

sudo apt-get install apt-transport-https
sudo apt-get install software-properties-common wget
wget -q https://packages.spring.io/debian/dists/spring-boot/stable/main/binary-amd64/Packages
sudo dpkg -i Packages

安装 Siege

sudo apt-get install siege

安装 Helm

curl https://baltocdn.com/helm/signing.asc | gpg --dearmor | sudo tee /usr/share/keyrings/helm.gpg > /dev/null
sudo apt-get install apt-transport-https --yes
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/helm.gpg] https://baltocdn.com/helm/stable/debian/ all main" | sudo tee /etc/apt/sources.list.d/helm-stable-debian.list
sudo apt-get update
sudo apt-get install helm

安装 kubectl

curl -LO "https://dl.k8s.io/release/v1.26.1/bin/linux/amd64/kubectl"
sudo install -o root -g root -m 0755 kubectl /usr/local/bin/kubectl

安装 minikube

curl -LO https://storage.googleapis.com/minikube/releases/v1.29.1/minikube-linux-amd64
sudo install minikube-linux-amd64 /usr/local/bin/minikube

安装 istioctl

curl -L https://istio.io/downloadIstio | ISTIO_VERSION=1.17.0 TARGET_ARCH=amd64 sh -
sudo install istio-1.17.0/bin/istioctl /usr/local/bin/istioctl

2.6 验证工具安装

在 Linux 服务器上安装完所有工具后，需要验证工具是否安装成功。

git --version
java -version
curl --version
jq --version
spring --version
siege --version
helm version --short
kubectl version --client
minikube version
istioctl version --remote=false

2.7 获取源代码

与 macOS 环境类似，在 Windows 环境下也可以从 GitHub 仓库获取源代码。

export BOOK_HOME=~/Documents/Microservices-with-Spring-Boot-and-Spring-Cloud-Third-Edition 
git clone https://github.com/PacktPublishing/Microservices-with-Spring-Boot-and-Spring-Cloud-Third-Edition.git $BOOK_HOME

2.8 使用 Visual Studio Code 开发

为了更方便地开发和调试代码，推荐使用 Visual Studio Code 并安装 Remote - WSL 扩展。
1. 打开 Visual Studio Code，点击左侧边栏的扩展图标，搜索 “Remote - WSL” 并安装。
2. 安装完成后，点击左下角的绿色图标，选择 “Remote - WSL: New Window” 打开一个新的基于 WSL 的窗口。
3. 在新窗口中，使用 “File” -> “Open Folder” 打开之前下载的源代码文件夹。

2.9 整体流程总结

以下是在 macOS 和 Windows 环境下安装开发工具和获取源代码的整体流程：

graph LR
    classDef startend fill:#F5EBFF,stroke:#BE8FED,stroke-width:2px;
    classDef process fill:#E5F6FF,stroke:#73A6FF,stroke-width:2px;
    classDef decision fill:#FFF6CC,stroke:#FFBC52,stroke-width:2px;

    A([开始]):::startend --> B{操作系统类型}:::decision
    B -->|macOS| C(安装 Homebrew):::process
    B -->|Windows| D(安装 WSL 2 和 Ubuntu):::process
    C --> E(使用 Homebrew 安装部分工具):::process
    D --> E1(安装 Windows Terminal):::process
    E --> F(手动安装 minikube、kubectl 和 istioctl):::process
    E1 --> E2(安装 Docker Desktop for Windows):::process
    F --> G(安装后配置 Java 和 Docker):::process
    E2 --> E3(在 Linux 服务器上安装工具):::process
    G --> H(验证工具安装):::process
    E3 --> H
    H --> I(获取源代码):::process
    I --> J([结束]):::startend