Neo4j Windows 环境搭建与安装实战

Neo4j Windows 环境搭建与安装实战

在图数据库开发前，确保运行环境稳定是第一步。Neo4j 基于 Java 构建，因此 JDK 的版本匹配至关重要。本文将结合 Windows 系统特性，梳理 JDK 与 Neo4j 的兼容性关系，并演示从环境配置到服务启动的全流程。

JDK 与 Neo4j 版本对应关系

不同版本的 Neo4j 对 Java 运行时环境有明确要求，选错版本可能导致启动失败。以下是常见的版本对照表：

Neo4j 版本	JDK 版本
3.x	Java SE 8
4.x	Java SE 11
5.x	Java SE 17
5.14 及更高版本、5.26 LTS	Java SE 17 和 Java SE 21
2025.01	Java SE 21

建议优先选择长期支持版（LTS），如 JDK 11 或 17，以获得更好的稳定性。

准备 JDK 环境

下载与解压

前往 Oracle 官网或 OpenJDK 社区获取安装包。以 JDK 11 为例，下载适用于 Windows 的 zip 包后，将其解压至一个无中文、无空格的目录，例如 C:\Program Files\Java。

配置环境变量

为了让系统识别 Java 命令，需要配置两个关键变量：

1. 新建 JAVA_HOME 右键点击'此电脑' > '属性' > '高级系统设置' > '环境变量'。在'系统变量'区域点击'新建'，变量名设为 JAVA_HOME，变量值指向 JDK 的安装根目录（如 C:\Program Files\Java\jdk-11.0.2）。

2. 编辑 Path 变量 在系统变量中找到 Path，选中后点击'编辑'，新建一条记录输入 %JAVA_HOME%\bin。这一步是为了让命令行能直接调用 java 等指令。

3. 验证配置 打开新的命令提示符窗口（cmd），输入 java -version。如果能看到类似 java version "11.0.2" 的输出，说明配置成功。

安装与启动 Neo4j

下载与解压

访问 Neo4j 官网下载社区版安装包。将压缩包解压到你希望存放数据的目录，比如 D:\neo4j。解压后的文件夹结构通常包含 bin、data、plugins 等子目录。

配置环境变量

为了方便在任何目录下启动 Neo4j，同样需要将 Neo4j 的 bin 目录加入系统 PATH。

1. 进入'环境变量'设置界面。
2. 找到 Path 变量并编辑。
3. 添加 Neo4j 的 bin 路径，例如 D:\neo4j\neo4j-community-4.2.3\bin。
4. 保存后，在 cmd 中输入 neo4j-admin.bat --version 验证是否生效。

启动服务

Neo4j 提供了多种启动方式，理解它们的区别有助于调试：

• console：控制台模式。服务在当前窗口运行，日志实时打印。适合开发调试，但关闭窗口即停止服务。