本地开发环境搭建

码匠君 ... 2021-10-28 大约 15 分钟

# 本地开发环境搭建

# Java 开发环境

# [1]JDK 安装及配置

# (1)下载 JDK

下载 Java SE Development Kit (JDK) 下载地址 (opens new window)

说明

建议下载 JDK 8, 更高的版本逻辑上是向下兼容的,但是本系统还没有进行过验证。

# (2)安装 JDK

点击安装下载后的JDK安装文件,全部点击下一步即可。

提示

建议全部点击下一步安装,不要修改安装目录等内容,全部默认安装。一方面,在没有搞清楚 JDK 和 JRE 区别时,不建议修改安装目录,这经常会导致装错或者漏装;另一方面,个人觉得装在默认目录挺好,方便定位查找,重装系统也一并清除了。

只是个人建议,请结合自己的实际情况和考虑安装。

# (3)配置JDK环境变量(Windows)

右键点击 Windows 左下角的 Windows 图标,选择 系统—>高级系统设置—>环境变量

  1. 系统变量 栏中,点击新建,弹出 编辑系统变量 对话框。
  • 变量名(N) 中,输入变量名称 JAVA_HOME
  • 变量值(V) 中,输入JDK 所在目录 C:\Program Files\Java\jdk1.8.0_301

注意

JDK 安装完成之后,会在 C:\Program Files\Java 目录中生成两个目录, 以 Java SE Development Kit 8u301 为例,生成的目录就是:jdk1.8.0_301jre1.8.0_301

变量值(V) 中,我们要配置的是 jdk1.8.0_301 目录地址,而不是 jre1.8.0_301

点击 编辑系统变量 对话框中的【确定】按钮,保存配置。

  1. 还是在 系统变量 栏中,找到 Path 变量,点击编辑, 弹出 编辑环境变量 对话框

编辑环境变量 对话框中,添加 %JAVA_HOME%\bin

说明

%JAVA_HOME% 的意思,即使引用上一步中,定义的变量 JAVA_HOME 的 变量值。

点击 编辑环境变量 对话框中的【确定】按钮,保存配置。

# (4)验证JDK安装

说明

至此,JDK环境变量已经配置完成。以上这些配置已经可以完全满足JAVA开发的正常需要,除非特别的应用需求,比如说本地运行自定义的,需要独立运行的纯Java程序外,不再需要像网上说的,还要配置什么 . , classpath, tools.jar 之类的东西。

新打开一个命令提示符(CMD),输入以下命令:

java -version
1

如果可以正确显示版本信息,说明安装成功,如下图所示。

jdk-validation

注意

CMD 自身有 Session 机制,每次打开是以当前的环境变量配置作为依据运行。环境变量配置完成之后,如果使用之前的 CMD 窗口,新的环境变量配置将不会生效。所以一定要注意,重新开一个 CMD 窗口进行安装验证。

# [2]Maven 安装及配置

# (1)下载Maven

下载 Apache Maven 下载地址 (opens new window)

# (2)解压缩 Maven

将下载好的 apache-maven-XXXX-bin.zip, 解压到你想要放置的任何位置。

说明

Maven 是 Java 开发常用的工具,建议最好找一个相对固定的位置放置,一方面,不需要频繁修改和更换版本;另一方面,主要是好找,方便反复使用。

# (3)配置Maven环境变量(Windows)

右键点击 Windows 左下角的 Windows 图标,选择 系统—>高级系统设置—>环境变量

  1. 系统变量 栏中,点击新建,弹出 编辑系统变量 对话框。
  • 变量名(N) 中,输入变量名称 MAVEN_HOME
  • 变量值(V) 中,输入 Maven 所在目录,这里以 D:\Environment\apache-maven-3.8.2 为例,请根据实际情况进行修改。

点击 编辑系统变量 对话框中的【确定】按钮,保存配置。

  1. 还是在 系统变量 栏中,找到 Path 变量,点击编辑, 弹出 编辑环境变量 对话框

编辑环境变量 对话框中,添加 %MAVEN_HOME%\bin

说明

%MAVEN_HOME% 的意思,即使引用上一步中,定义的变量 MAVEN_HOME 的 变量值。

点击 编辑环境变量 对话框中的【确定】按钮,保存配置。

# (4)验证Maven安装

新打开一个命令提示符(CMD),输入以下命令:

如果可以正确显示版本信息,说明安装成功,如下图所示。

maven-validation

注意

CMD 自身有 Session 机制,每次打开是以当前的环境变量配置作为依据运行。环境变量配置完成之后,如果使用之前的 CMD 窗口,新的环境变量配置将不会生效。所以一定要注意,重新开一个 CMD 窗口进行安装验证。

# (5)创建本地仓库目录

建议找一个相对固定的位置,创建任意名称的文件夹,作为本地仓库存储 Maven 下载的依赖。

说明

使用 Maven 时,Maven 会从中央库,将 pom.xml 中依赖的组件,下载至本地供开发和编译使用。默认情况下,Maven 会将下载的依赖组件,放置到系统盘中的 .m2 目录下。这不仅会慢慢撑大系统盘空间的使用,如果重装系统,相关的组件又需要重新下载。

指定一个文件夹,作为本地 Maven 存储仓库,可以减少依赖组件的反复下载,起到重复使用的作用。

这里以 maven-repository 为例,放在与 apache-maven-3.8.2 平级的目录下。只是示例,请根据实际情况修改。

# (6)修改 Maven 配置

在 Maven 安装目录下,找到 settings.xml 文件,具体路径为 ${maven_home}/conf/settings.xml

用任意编辑器打开 settings.xml 文件中,找到被注释掉的 <localRepository> 节点,在其下方添加以下配置:

<localRepository>D:/Environment/maven-repository</localRepository>
1

说明

这里的路径,就是上一步中创建的本地 Maven 存储仓库文件夹所在的路径。

注意:路径的格式,斜杠的方向。不同的操作系统,会略有不同。

settings.xml 文件中,找到 <mirrors> 节点,在其内部添加以下配置:

<mirror>
    <id>aliyunmaven</id>
    <mirrorOf>*</mirrorOf>
    <name>阿里云公共仓库</name>
    <url>https://maven.aliyun.com/repository/public</url>
</mirror>
1
2
3
4
5
6

说明

Maven 默认是从中央仓库进行依赖的下载,具体地址为 https://repo.maven.apache.org/maven2。因为涉及到国外网络,下载速度比较慢。通过上面的配置,将 Maven 仓库修改为阿里公共仓库,依赖下载速度会快很多。

阿里公共仓库会同步中央库的内容,可以放心使用,不用担心内容不全的问题。当然,可以根据你自身的情况添加其它的仓库。

# [3]Git 安装

下载 Git 下载地址 (opens new window)

全部使用默认设置,一路 Next 安装即可

# [4]Idea 安装及配置

# (1)下载 Idea

下载 Idea 下载地址 (opens new window)

全部使用默认设置,一路 Next 安装即可

具体怎么激活,请自行百度

这里为什么将 Idea 安装放在第四部分说明?

主要原因是,JDK,Maven 和 Git 均已安装配置好之后,再来安装 Idea,Idea 就会自动读取 JAVA_HOME, MAVEN_HOME 以及 Git的安装路径等信息,并进行自动配置。就无须再手动配置这些信息,使用起来比较方便。

如果没有按照,上面所说的顺序,已经提前安装好了Idea。可以在JDK,Maven 和 Git 均已安装配置好之后,重新启动 Idea,JAVA_HOME, MAVEN_HOME 以及 Git的安装路径等信息也会被读取并进行设置。

# (2)在 Idea 中修改 Maven 配置

打开 Idea,点击 File -> Settings... -> Maven,打开 Maven 配置面板,如下图所示:

maven-config-01

在 Maven 配置面板中,修改 Maven 的配置。

  1. 设置 Maven home path

在 Maven 配置面板中,设置 Maven home path 的值,如果 Maven 的环境变量配置正确,那么在 Maven home path 选择下拉框中,就可以找到当前环境变量中配置的 Maven 信息,这个值就是环境变量 MAVEN_HOME 中配置的值。如下图所示:

maven-config-02

  1. 设置 User setting files

在 Maven 配置面板中,首先勾选 User setting files 设置后面的 Override,勾选之后 User setting files 的选择框就会变为激活的状态。

点击 User setting files 设置中的 文件夹 按钮,选择 ${maven_home}/conf/settings.xml 文件,具体如下图所示:

maven-config-03

如果 ${maven_home}/conf/settings.xml 文件已经正确配置,并且在 User setting files 设置中也选择正确的情况下,Local repository 配置就会自动显示出自定义本地仓库的路径,这个路径就是刚刚,在 ${maven_home}/conf/settings.xml 中设置的 <localRepository> 的值,这就说明配置成功。如上图所示。

注意

当前截图使用的是 Idea 2021.2.3 版本,之前发现有些低版本Idea,不会自动读取 ${maven_home}/conf/settings.xml 中配置的 <localRepository> 值。

如果出现这种情况,勾选 Local repository 后面的 Override,激活 Local repository 设置的文件选择框,手动选择一下你所定义的本地仓库文件夹,即可解决。

# (3)在 Idea 中修改 Maven 的全局配置

Idea 中很多设置否分为两种,一种设置只是针对当前工程,这种设置只是针对当前工程有效,打开新的工程或者重新检出当前工程就需要重新配置;一种设置是针对新工程,配置之后所有用 Idea 打开工程都会生效,就不需要重新设置。

上一步中进行 Maven 设置,就是前一种设置,只对当前工程有效,打开新的工程或者重新检出当前工程就需要重新设置 Maven。

可以通过下面的方式,进行 Maven 的 “全局” 配置。

点击 File -> New Projects Setup -> Settings For New Prjects...,会跳出全局设置面板,如下图所示:

maven-config-04

在这个面板中,找到 Maven 配置,重复进行上一步的操作即可。

# [5]检出代码和编译

IDEA 中,点击菜单 File -> New -> Project From Version Control..., 在弹出框中输入本工程Git地址:https://gitee.com/herodotus/eurynome-cloud.git (opens new window),然后设置放置目录,点击 OK 即可。

在这个过程中,Idea 会从 Git 中检出代码,并且检查 pom.xml 中的依赖,如果本地仓库中没有,就从配置的中央库中重新下载。

检查上文中,自定义的本地 Maven 仓库,如果有依赖包更新,说明全部配置成功。

说明

  • 如果是初次搭建Java的开发环境,那么本地 Maven 仓库中内容是空的,就会需要一定时间下载所有的依赖库,具体所需时间根据网络情况的不同会有差异。

  • 如果是初次搭建Java的开发环境,由于下载的依赖包较多,Idea 解析不过来,会导致 Idea 右侧 Maven 面板中有些依赖标成红色。如果已经确定所有的依赖均已下载完成,可以编译一下代码,编译代码参见:环境部署,如果可以编译成功,说明环境正常,下次启动 Idea 右侧 Maven 面板中被标成红色依赖就会消失

提示

如果本地Java开发环境,不是严格按照本文档顺序进行搭建的。特别是已经提前检出了代码,那么有可能不会自动出发 Idea Maven 的更新机制。

可以根据第三步中的描述,修改完 Maven 的配置之后,点击下图中的刷新按钮,手动触发 Maven 的更新和下载。

如果发现有编译错误,可以先检查一下 Maven 配置,确保配置没有问题后,尝试点击刷新按钮,多数情况下问题都可以解决。

在IDEA中,打开 Maven 面板,点击刷新按钮。如下图所示:

refresh-maven

# Node 开发环境

# [1]Nodejs 安装

下载 Nodejs,下载地址 (opens new window),按照提示安装即可,记得选择将Nodejs增加到PATH一项,如果界面上没有,应该就是默认帮你搞定了,可以忽略。

安装完成后,通过命令,验证是否安装成:

node -v

npm -v
1
2
3

如果正常显示版本号,即安装成功。

# [2]Nodejs 配置

Nodejs安装完成之后,默认会将Node.exe的路径,添加到系统的环境变量中,如果没有请手动添加。

Nodejs 默认的缓存目录和全局安装目录都在系统盘,会占用大量的系统盘空间,所以建议修改,如果不想修改,请跳过此部分内容。

# (1)配置prefix和cache目录

prefix 就是 Nodejs 来全局安装的位置,cache 就是 Nodejs 依赖下载缓存的目录

  • 改变 npm prefix 全局安装位置
npm config set prefix "你的磁盘路径"
1

假设你所指定的根目录地址为:C:\Program Files\nodejs

npm config set prefix “C:\Program Files\nodejs\node_global”
1
  • 改变 npm cache 缓存位置
npm config set cache "你的磁盘路径"
1

假设你所指定的根目录地址为:C:\Program Files\nodejs

npm config set cache  “C:\Program Files\nodejs\node_cache
1

# (2)配置环境变量

Nodejs 在安装过程中,会自动配置 Path 环境变量。但这个环境变量只是针对 NodeNpm 有效。对于一些全局安装的应用,例如 @vue/cli,如果不配置环境变量,它的相关命令是无法正常执行的。

右键点击 Windows 左下角的 Windows 图标,选择 系统—>高级系统设置—>环境变量

  1. 系统变量 栏中,点击新建,弹出 编辑系统变量 对话框。
  • 变量名(N) 中,输入变量名称 NODE_PATH
  • 变量值(V) 中,输入上一步中指定的 prefix 加上 node_modules 文件夹,如下所示,请根据实际情况修改
C:\Program Files\nodejs\node_global\node_modules
1

说明

这个值就是上一步中,通过 “npm config set prefix” 设置的值。可以,用下面命令查看

npm config get prefix
1

切记,一定要加上 \node_modules。因为,有些全局应用是安装在 C:\Program Files\nodejs\node_global\node_modules 目录下

点击 编辑系统变量 对话框中的【确定】按钮,保存配置。

  1. 用户变量 栏中, 找到 Path 变量,点击编辑, 弹出 编辑环境变量 对话框

编辑环境变量 对话框中,添加 C:\Program Files\nodejs\node_global\

这个值就是上一步中,通过 “npm config set prefix” 设置的值。

至此,Node 相关的环境变量配置完成。

# (3)配置阿里源

将 Npm 的下载源,修改为阿里源,可以提升依赖包下载速度,执行一下命令设置。

npm config set registry https://registry.npm.taobao.org
1

# [3]Yarn 简介

Yarn 是 Facebook 发布的一款取代 npm 的包管理工具。

Yarn的特点:

  • 速度超快。Yarn 缓存了每个下载过的包,所以再次使用时无需重复下载。 同时利用并行下载以最大化资源利用率,因此安装速度更快。
  • 超级安全。在执行代码之前,Yarn 会通过算法校验每个安装包的完整性。
  • 超级可靠。使用详细,简洁的锁文件格式和明确的安装算法,Yarn 能够保证在不同系统上无差异的工作。

# [4]Yarn 安装

  • 方式一:使用 npm 安装
npm install -g yarn
1
  • 方式二:使用安装文件安装

即在官网中下载exe文件安装(Windows),其它系统根据实际情况安装。

# [5]Yarn 配置

# (1)配置 Yarn prefix 和 cache目录

使用 Yarn,那么下载依赖包时,将使用 Yarn 的全局 prefix 和 cache目录,同时将 Yarn 的全局安装应用与 Node 进行关联

  • 改变 Yarn 全局安装位置
yarn config set global-folder "你的磁盘路径"
1

假设你所指定的根目录为:C:\Program Files\yarn

yarn config set global-folder "C:\Program Files\yarn\global"
1
  • 改变 yarn 缓存位置
yarn config set cache-folder "你的磁盘路径"
1

假设你所指定的根目录为:C:\Program Files\yarn

yarn config set cache-folder "C:\Program Files\yarn\cache"
1

或者在你系统盘的用户目录找到 .yarnrc 的文件,打开它,直接进行编辑

# (2)配置 Yarn 环境变量

在我们使用全局安装包的时候,会在 C:\Program Files\yarn\global(上面的示例路径,要根据自己的实际情况配置) 目录下生成 node_modules.bin 目录

需要将 C:\Program Files\yarn\global\node_modules\.bin 整个目录 添加到系统环境变量中去,否则通过 yarn 添加的全局包 在cmd 中是找不到的。

右键点击 Windows 左下角的 Windows 图标,选择 系统—>高级系统设置—>环境变量

系统变量 栏中,找到 Path 变量,点击编辑, 弹出 编辑环境变量 对话框

编辑环境变量 对话框中,添加 ``C:\Program Files\yarn\global\node_modules.bin`

点击 编辑环境变量 对话框中的【确定】按钮,保存配置。

提示

可以通过下面的命令,检查当前 yarn 的 bin 目录的位置

yarn global bin
1

# (3)Yarn 配置阿里源量

  1. 查看一下当前源
yarn config get registry
1
  1. 切换为淘宝源
yarn config set registry https://registry.npm.taobao.org

1
2
上次编辑于: 2021年11月4日 16:49
贡献者: herodotus