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

最新推荐文章于 2025-11-25 19:20:24 发布

gin88

最新推荐文章于 2025-11-25 19:20:24 发布

阅读量26

点赞数

CC 4.0 BY-SA版权

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

本文链接：https://blog.youkuaiyun.com/gin88/article/details/150362221

掌握Spring Boot 3与微服务架构精髓专栏收录该内容

53 篇文章 ¥499.90

订阅专栏¥69.90

会员秒杀 ¥9.9 重磅福利

超级会员免费看

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

1. macOS系统安装指南

1.1 技术要求

所有相关命令在搭载macOS Ventura系统的MacBook Pro上运行，使用bash命令行。这些命令已在基于Intel和Apple硅芯片的MacBook Pro上验证。若使用其他shell（如zsh），建议在运行命令前切换到bash：

/bin/bash

1.2 工具安装

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

多数工具将使用Homebrew包管理器（https://brew.sh/）安装，先安装Homebrew：

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

验证安装：

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安装命令不同：
- 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

Apple硅芯片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 安装后操作

Java
添加命令到登录脚本设置 JAVA_HOME 环境变量：

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

Docker
建议配置Docker使用大部分CPU（留少数）和10GB内存（若可用）。先确保Docker守护进程运行，可通过Spotlight或在Finder中打开应用程序文件夹启动。
点击状态栏Docker图标，选择“Preferences…”，在“Resources”选项卡设置CPU和内存，在“General”选项卡可选择“Start Docker Desktop when you log in”，最后点击“Apply & Restart”。

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。
下载源代码到文件夹并设置环境变量 $BOOK_HOME ：

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

建议使用支持Spring Boot应用开发的IDE（如Visual Studio Code、Spring Tool Suite或IntelliJ IDEA Ultimate Edition）处理Java代码。代码结构上，各章节包含多个Java项目，使用Gradle构建，遵循Gradle标准文件结构。

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 工具安装

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 | https://www.microsoft.com/en-us/p/windows-terminal/9n0dx20hk701 | v1.16.10261.0 |
| Docker Desktop for Windows | https://hub.docker.com/editions/community/docker-ce-desktop-windows/ | v4.14.0 |
| Visual Studio Code及Remote WSL扩展 | https://code.visualstudio.com 和 https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-wsl | v1.75.1 |
Linux服务器上安装的工具
| 工具 | 下载链接 | 使用版本 |
| ---- | ---- | ---- |
| Git | https://git-scm.com/downloads | v2.34.1 |
| Java | https://adoptium.net/installation | v17.0.6 |
| curl | https://curl.haxx.se/download.html | v7.81.0 |
| jq | https://stedolan.github.io/jq/download/ | v1.6 |
| Spring Boot CLI | https://docs.spring.io/spring-boot/docs/3.0.4/reference/html/getting-started.html#getting-started.installing.cli | v3.0.4 |
| Siege | https://github.com/JoeDog/siege#where-is-it | v4.0.7 |
| Helm | https://helm.sh/docs/intro/install/#from-apt-debianubuntu | v3.11.2 |
| kubectl | https://kubernetes.io/docs/tasks/tools/install-kubectl-linux/ | v1.26.1 |
| minikube | https://minikube.sigs.k8s.io/docs/start/ | v1.29.1 |
| istioctl | https://istio.io/latest/docs/setup/getting-started/#download | v1.17.0 |

2.3 在Windows上安装工具

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

macOS与Windows环境下开发工具安装指南（续）

2. Windows系统安装指南（续）

2.4 在Linux服务器上安装工具

在完成Windows上必要工具的安装后，接下来要在运行于WSL 2的Linux服务器上安装一系列工具。以下是详细的安装步骤：
- Git ：可通过命令行工具进行安装，具体命令可参考官方文档https://git-scm.com/downloads 。
- Java ：从https://adoptium.net/installation 下载并安装Java v17.0.6 。
- curl ：依据https://curl.haxx.se/download.html 的指引完成安装，版本为v7.81.0 。
- jq ：按照https://stedolan.github.io/jq/download/ 的说明安装，使用版本v1.6 。
- Spring Boot CLI ：参考https://docs.spring.io/spring-boot/docs/3.0.4/reference/html/getting-started.html#getting-started.installing.cli 进行安装，版本是v3.0.4 。
- Siege ：根据https://github.com/JoeDog/siege#where-is-it 的介绍来安装，版本为v4.0.7 。
- Helm ：按照https://helm.sh/docs/intro/install/#from-apt-debianubuntu 的步骤，安装版本v3.11.2 的Helm 。
- kubectl ：依据https://kubernetes.io/docs/tasks/tools/install-kubectl-linux/ 的说明安装v1.26.1 版本的kubectl 。
- minikube ：参考https://minikube.sigs.k8s.io/docs/start/ 的指引，安装v1.29.1 版本的minikube 。
- istioctl ：按照https://istio.io/latest/docs/setup/getting-started/#download 的步骤安装v1.17.0 版本的istioctl 。

以下是mermaid格式的流程图，展示在Linux服务器上安装工具的流程：

graph LR
    A[开始] --> B[安装Git]
    B --> C[安装Java]
    C --> D[安装curl]
    D --> E[安装jq]
    E --> F[安装Spring Boot CLI]
    F --> G[安装Siege]
    G --> H[安装Helm]
    H --> I[安装kubectl]
    I --> J[安装minikube]
    J --> K[安装istioctl]
    K --> L[结束]

2.5 验证工具安装

在Linux服务器上安装完所有工具后，需要对安装情况进行验证。可以通过运行各工具的版本查询命令来确认是否安装成功，以下是各工具的版本查询命令：
| 工具 | 验证命令 |
| ---- | ---- |
| Git | git --version |
| Java | java -version |
| curl | curl --version |
| jq | jq --version |
| Spring Boot CLI | spring --version |
| Siege | siege --version |
| Helm | helm version --short |
| kubectl | kubectl version --client -o json | jq -r .clientVersion.gitVersion |
| minikube | minikube version |
| istioctl | istioctl version --remote=false |

3. 开发环境的使用与注意事项

3.1 源代码的使用

获取到源代码后，在开发过程中要注意其结构和使用方式。源代码中的每个章节都包含多个Java项目，这些项目使用Gradle进行构建，并且遵循Gradle的标准文件结构。例如，一个典型的项目结构如下：

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

在实际开发中，可以根据项目的需求对这些文件进行修改和扩展。同时，建议使用支持Spring Boot应用开发的IDE，如Visual Studio Code、Spring Tool Suite或IntelliJ IDEA Ultimate Edition ，这样可以提高开发效率。

3.2 环境变量的设置

在安装和配置过程中，设置环境变量是非常重要的一步。例如，在macOS系统中，需要设置 JAVA_HOME 环境变量，以确保Java相关的工具能够正常使用。具体设置方法如下：

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

在Windows系统中，虽然没有类似的 JAVA_HOME 设置，但在使用WSL 2和Linux服务器时，也需要注意环境变量的配置，以保证各工具之间的兼容性和正常运行。

3.3 资源配置的重要性

在使用Docker时，合理配置资源是确保开发和测试顺利进行的关键。建议为Docker分配大部分CPU（留少数）和10GB内存（若可用），这样可以保证在运行多个微服务时系统的稳定性。具体配置步骤如下：
1. 确保Docker守护进程运行，可以通过Spotlight或在Finder中打开应用程序文件夹启动（macOS），或者在Windows中通过相应的方式启动。
2. 点击状态栏Docker图标，选择“Preferences…”。
3. 在“Resources”选项卡中设置CPU和内存。
4. 在“General”选项卡中可选择“Start Docker Desktop when you log in”，方便下次登录时自动启动。
5. 最后点击“Apply & Restart”使配置生效。

4. 总结

通过以上详细的步骤，我们可以在macOS和Windows系统上完成开发所需工具的安装和配置。在macOS系统中，利用Homebrew包管理器可以方便地安装大部分工具，但对于一些需要精确控制版本的工具，如minikube、kubectl和istioctl ，则需要手动下载和安装。在Windows系统中，借助WSL 2和Ubuntu服务器可以模拟Linux环境，从而顺利运行各种开发命令。

在整个安装和配置过程中，要注意各工具的版本兼容性，特别是在使用Kubernetes和Istio相关工具时，不同版本之间可能存在不兼容的情况。同时，合理配置资源和设置环境变量也是确保开发环境稳定和高效运行的重要因素。希望以上内容能够帮助开发者顺利搭建开发环境，开展后续的开发工作。