本地开发环境搭建
码匠君 ... 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 图标，选择 系统—>高级系统设置—>环境变量。
- 在
系统变量栏中，点击新建，弹出编辑系统变量对话框。
- 在
变量名(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_301 和 jre1.8.0_301。
在 变量值(V) 中，我们要配置的是 jdk1.8.0_301 目录地址，而不是 jre1.8.0_301
点击 编辑系统变量 对话框中的【确定】按钮，保存配置。
- 还是在
系统变量栏中，找到Path变量，点击编辑， 弹出编辑环境变量对话框
在 编辑环境变量 对话框中，添加 %JAVA_HOME%\bin
说明
%JAVA_HOME% 的意思，即使引用上一步中，定义的变量 JAVA_HOME 的 变量值。
点击 编辑环境变量 对话框中的【确定】按钮，保存配置。
# （4）验证JDK安装
说明
至此，JDK环境变量已经配置完成。以上这些配置已经可以完全满足JAVA开发的正常需要，除非特别的应用需求，比如说本地运行自定义的,需要独立运行的纯Java程序外，不再需要像网上说的，还要配置什么 . , classpath, tools.jar 之类的东西。
新打开一个命令提示符（CMD），输入以下命令：
java -version
1
如果可以正确显示版本信息，说明安装成功，如下图所示。
注意
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 图标，选择 系统—>高级系统设置—>环境变量。
- 在
系统变量栏中，点击新建，弹出编辑系统变量对话框。
- 在
变量名(N)中，输入变量名称MAVEN_HOME - 在
变量值(V)中，输入 Maven 所在目录，这里以D:\Environment\apache-maven-3.8.2为例，请根据实际情况进行修改。
点击 编辑系统变量 对话框中的【确定】按钮，保存配置。
- 还是在
系统变量栏中，找到Path变量，点击编辑， 弹出编辑环境变量对话框
在 编辑环境变量 对话框中，添加 %MAVEN_HOME%\bin
说明
%MAVEN_HOME% 的意思，即使引用上一步中，定义的变量 MAVEN_HOME 的 变量值。
点击 编辑环境变量 对话框中的【确定】按钮，保存配置。
# （4）验证Maven安装
新打开一个命令提示符（CMD），输入以下命令：
如果可以正确显示版本信息，说明安装成功，如下图所示。
注意
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
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 配置面板中，修改 Maven 的配置。
- 设置
Maven home path
在 Maven 配置面板中，设置 Maven home path 的值，如果 Maven 的环境变量配置正确，那么在 Maven home path 选择下拉框中，就可以找到当前环境变量中配置的 Maven 信息，这个值就是环境变量 MAVEN_HOME 中配置的值。如下图所示：
- 设置
User setting files
在 Maven 配置面板中，首先勾选 User setting files 设置后面的 Override，勾选之后 User setting files 的选择框就会变为激活的状态。
点击 User setting files 设置中的 文件夹 按钮，选择 ${maven_home}/conf/settings.xml 文件，具体如下图所示：
如果 ${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 配置，重复进行上一步的操作即可。
# [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 面板，点击刷新按钮。如下图所示：
# Node 开发环境
# [1]Nodejs 安装
下载 Nodejs，下载地址 (opens new window)，按照提示安装即可，记得选择将Nodejs增加到PATH一项，如果界面上没有，应该就是默认帮你搞定了，可以忽略。
安装完成后，通过命令，验证是否安装成：
node -v
npm -v
1
2
3
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 环境变量。但这个环境变量只是针对 Node 和 Npm 有效。对于一些全局安装的应用，例如 @vue/cli，如果不配置环境变量，它的相关命令是无法正常执行的。
右键点击 Windows 左下角的 Windows 图标，选择 系统—>高级系统设置—>环境变量。
- 在
系统变量栏中，点击新建，弹出编辑系统变量对话框。
- 在
变量名(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目录下
点击 编辑系统变量 对话框中的【确定】按钮，保存配置。
- 在
用户变量栏中， 找到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 配置阿里源量
- 查看一下当前源
yarn config get registry
1
- 切换为淘宝源
yarn config set registry https://registry.npm.taobao.org
1
2
2