mac开发环境配置笔记

news2025/4/26 11:34:08

1. 终端配置

参考： Mac终端配置笔记-CSDN博客

2. 下载JDK

到 oracle官网下载jdk:

oracle官网 :Java Downloads | Oracle
mac的芯片为Intel系列下载 x64版本的jdk；为Apple Mx系列使用 Arm64版本；
oracle官网下载时报错：400 Bad Request Request Header Or Cookie Too Large，解决办法： “Command+Shift+N” 进入浏览器隐身模式，在隐身模式下访问oracle下载页面
- 参考文档：在oracle下载jdk-8u162-linux-x64.tar.gz显示400 Bad Request Request Header Or Cookie Too Large_oracle request header or cookie too large-CSDN博客

这里以jdk11为例，下载完后，点击安装，默认安装路径 “/Library/Java/JavaVirtualMachines/jdk-11.jdk/Contents/Home”。设置java home，指定java使用自己安装的版本:

# step1:进入～文件夹
cd ~

# step2: 编辑(若没有该文件则会自动新建) .bash_profile文件
vim .bash_profile

# step3: 按 i 进入插入模式,在文件中新增如下配置
#修改java默认路径为自己下载安装的java版本
export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-11.jdk/Contents/Home
export PATH=$PATH:$JAVA_HOME

# step4. 按 esc 退出编辑, 输入:wq保存并退出文件

# step5. 使新配置生效
source .bash_profile

3. 安装IDE

使用idea，根据需要选择下载版本：Download IntelliJ IDEA

4. 安装Maven

这里安装的Maven是在mac终端和IDEA的terminal窗口里使用，和IDEA使用的maven是两回事。IDEA一般默认使用其自带的maven(当然也可以手动指定为用户自己安装的版本)

4.1. 方案一：使用brew命令安装

使用 brew install maven 命令安装maven:

使用 brew 命令安装不需要手动设置环境变量
安装完使用 mvn -version 命令验证是否安装成功

引申问题：运行 brew install maven 时报错：zsh: command not found: brew ，说明没有安装homobrew，需要先安装 homobrew

# step1: 使用下面命令安装Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# step2. 检查Homebrew是否安装成功
brew -v

4.2. 方案二：手动从官网安装

从官网手动下载安装，需要配置环境变量

下载最新版本maven：http://maven.apache.org/download.cgi
配置环境变量

# step1:进入～文件夹
cd ~

# step2: 编辑(若没有该文件则会自动新建) .bash_profile文件
vim .bash_profile

# step3: 按 i 进入插入模式,在文件中新增如下配置
export MVN_HOME=/usr/local/apache-maven-x.x.x/bin
export PATH=$PATH:$MVN_HOME

# step4. 按 esc 退出编辑, 输入:wq保存并退出文件

# step5. 使新配置生效
source .bash_profile

# step6.验证是否安装成功
mvn -version

参考文档：

【学习笔记】mac安装maven与idea自带maven_mac mvn-CSDN博客
Mac 安装Maven的几种方法和操作步骤_mac安装maven-CSDN博客

其他信息：

maven安装好后，使用mvn命令时出现意料之外的错误，可以先通过 “mvn -v ”命令查看maven所依赖的 java版本是否正确(原始用的是openjdk版本)。

如果不是预期内的java版本，可以通过设置 java home，将java默认路径改为自己安装的java版本。

如果上述操作解决不了问题，再搜索其他解法。也可参考该文档附录部分的问题: 【学习笔记】mac安装maven与idea自带maven_mac mvn-CSDN博客

5. 配置git

mac默认已安装了git，通过 “ git -v ”命令可以验证是否已安装。如未安装可以使用 “brew install git ” 命令安装。

5.1. 配置用户名和邮箱

一般在新系统上，需要先配置下 Git 工作环境。配置工作只需一次，以后升级时还会沿用现在的配置。

#用户名和邮箱是【必须】配置项, 这个信息将用用于Git 提交
git config --global user.name  exampleName          # 设置用户名
git config --global user.email example@example.com  # 邮箱地址

# 这些建议配置项
git config --global push.default simple     # 要求 Git 版本 1.9.5 以上
git config --global core.autocrlf false     # 让Git不要管Windows/Unix换行符转换的事

配置完成后可以使用 “git config --global --list” 命令查看是否配置正确。这些git的全局变量配置文件在【～/.gitconifg 】中，也可以“cat ～/.gitconifg ”查看。

5.2. 配置SSH KEY

配置SSH Key主要是为了本地计算机和代码托管平台之间建立安全连接，否则可能没有权限从托管平台clone代码到本地。

# step1. 生成ssh key
ssh-keygen -t rsa -C 邮箱  #例如: ssh-keygen -t rsa -C example@example.com

# step2.获取你生成的公钥
cat ~/.ssh/id_rsa.pub

# step3.复制这个公钥放到代码托管平台-个人设置中的SSH Keys下