深度学习框架DeepLearning4J（DL4J）的安装及配置

article/2025/4/30 5:29:23

一、DeepLearning4J的简介和系统要求

1、DeepLearning4J简介

Deeplearning4J（以下简称DL4J）不是第一个开源的深度学习项目，但与此前的其他项目相比，DL4J在编程语言和宗旨两方面都独具特色。DL4J是基于JVM、聚焦行业应用且提供商业支持的分布式深度学习框架，其宗旨是在合理的时间内解决各类涉及大量数据的问题。它与Hadoop和Spark集成，可使用任意数量的GPU或CPU运行。DL4J和其他深度学习的框架对比请参考这篇文章，DL4J与Torch、Theano、TensorFlow、Caffe、Paddle、MxNet、Keras 和 CNTK的比较。

2、系统要求

Java（开发者版7或更新版本（仅支持64位版本）
Apache Maven
IntelliJ IDEA（建议）或Eclipse
Git

在使用以下指南之前，请先安装上述各项。DL4J主要面向熟悉各类生产部署工具、IDE和自动化构建工具的专业Java开发者。若您已熟悉这些工具，使用DL4J将易如反掌。本文默认你已经安装Java、Git、IDEA，没有安装的小伙伴请先安装后再继续看下面的教程。若你的机器已经具备以上要求，那就跟着我学习如何通过Maven安装DL4J吧，Let’s go~

二、Maven的安装及配置

1、下载Maven

下载地址为：http://maven.apache.org/download.cgi
在这里插入图片描述
点击图中红色圆圈的链接下载，本文下载的是3.6.0最新版本，你也可以使用其他版本。

2、配置环境变量

（1）新建系统变量，变量名为MAVEN_HOME，变量值为下载Maven的解压目录
在这里插入图片描述
（2）编辑环境变量Path，新增%MAVEN_HOME%\bin（非win10系统请在后面加英文分号分隔）

（3）（选做）设置Maven运行参数，新建系统变量，变量名为MAVEN_OPTS，变量值为-Xms128m -Xmx512m

由于Maven命令实际上是执行了Java命令，所以可以通过JAVA命令参数的方式来设置MAVEN运行参数，通常需要设置MAVEN_OPTS的值为-Xms128m -Xmx512m，因为Java默认的最大可用内存往往不能够满足Maven运行的需要，比如在项目较大时，使用Maven生成项目站点需要占用大量的内存，如果没有该配置，则很容易得到java.lang.OutOfMemeoryError

3、检验是否安装成功

打开dos命令窗口，输入mvn -v或mvn --version测试环境变量是否配置成功，若出现下图的提示则Maven安装成功
在这里插入图片描述

三、在IDEA中配置Maven

1、配置Maven

File -> settings -> Bulid, Execution, Deployment -> Build Tools -> Maven(快捷键 Ctrl + Alt + S) 找到maven默认的配置，可以修改，也可以用默认的。修改最后三项，下图为我修改后的配置：
在这里插入图片描述
Maven home directory：你下载的Maven的目录

User settings file：你下载Maven的settings文件地址

Local repository：设置本地Maven仓库地址

2、修改settings.xml文件

（1）修改本地仓库地址，加入下面一句，D:\MavenRepository是我的仓库地址，可按自己的需求修改

<localRepository>D:\MavenRepository</localRepository>

（2）配置阿里云镜像服务器，在mirrors标签中添加以下一段

 <mirror>  <id>alimaven</id>  <name>aliyun maven</name>  <url>http://maven.aliyun.com/nexus/content/groups/public/</url>  <mirrorOf>central</mirrorOf>          </mirror>

（3）在profiles标签下修改jdk版本，按自己所需配置

<profile>    <id>jdk-1.8</id>    <activation>    <activeByDefault>true</activeByDefault>    <jdk>1.8</jdk>    </activation>    <properties>    <maven.compiler.source>1.8</maven.compiler.source>    <maven.compiler.target>1.8</maven.compiler.target>    <maven.compiler.compilerVersion>1.8</maven.compiler.compilerVersion> </properties>
</profile>

四、获取DL4J示例代码

在命令行中输入以下代码，下载DL4J示例

git clone https://github.com/deeplearning4j/dl4j-examples.git

下载完成后，执行以下命令

cd dl4j-examples
mvn clean install

切换到dl4j-examples目录，然后使用Maven安装，运行结果如下图所示：
在这里插入图片描述
首次运行会下载很多依赖文件，时间较长。下载完成后，可以看到如下图所示的信息：

五、在IDEA中导入项目并运行

（1）打开IDEA，选择File->New->Project from Existing Sources，然后选择dl4j-examples的主目录，如下图所示
在这里插入图片描述
（2）选择“从外部模型导入项目”，确保已选中Maven，点击next

（3）点击右下方的Environment settings，在Maven environment中修改Maven目录，点击OK后其他默认，点击next

（4）在Select profiles中把OpenJFX和OpenJFX-11都勾选上，点击next

（5）之后一路next，继续按向导选项操作。选中以jdk开头的SDK。（可能需要点击加号才能看到相关选项……）随后点“完成”。稍等片刻，让IntelliJ IDEA加载所有的依赖项。右下方会显示进度条。

（6）加载完成后，发现pom.xml中有错误，需要修改pom.xml

将第44行修改为下面代码

<javafx.runtime.lib.jar>C:\Program Files\Java\jdk1.8.0_172\jre\lib\ext\jfxrt.jar</javafx.runtime.lib.jar>

第90行修改为：

<configFile>./contrib/formatter.xml</configFile>

第217行修改为：

<version>2.4</version>

修改后保存。

（7）在左边的树形目录中选择一个示例，本文选择的是MLPClassifierMoon，运行结果如下图
在这里插入图片描述

总结

本文介绍了如何在IDEA中使用Maven安装并配置DL4J，作为一篇DL4J的入门文章，希望可以给想学习DL4J或在DL4J安装中遇到问题的小伙伴一些帮助。接下来就可以深入研究和使用DL4J应用到自己的项目中。PS.如文中有错误，欢迎指正，谢谢~