前言
Neo4j 是一款强大的图数据库,擅长处理复杂的关系数据。本指南将介绍如何在 Windows 系统上完成 Neo4j 的安装、服务配置及基础使用。
系统要求
确保你的环境满足以下基本条件:
- 操作系统:Windows 10/11 (64 位)
- 内存:至少 4GB RAM(推荐 8GB 以上)
- 磁盘空间:至少 20GB 可用空间
- Java 版本:JDK 11 或更高版本
不同 Neo4j 版本对 JDK 的要求略有差异,参考如下:
| Neo4j 版本 | 官方推荐 JDK 版本 |
|---|---|
| 4.4.46 | JDK 11 |
| 5.26.13 | JDK 17 |
| 2025.09.0 | JDK 21 |
下文以 Neo4j 5.26.13 为例进行讲解。
准备 Java 环境
Neo4j 基于 JVM 运行,必须先安装 Java。如果不确定是否已安装,打开命令提示符输入 java -version。若显示版本号且大于等于 11,可直接跳过;否则需继续安装。
建议从 Oracle 官网或 OpenJDK 下载 JDK 17(对应 Neo4j 5.x)。下载 exe 安装包后按向导默认安装即可,通常会自动配置环境变量。安装完成后,重新打开终端验证 javac -version 确保编译工具也正常。
下载与解压
访问 Neo4j 官方网站下载 Community 版本。由于使用的是 5+ 版本,请确认 JDK 为 17。下载完成后,建议将压缩包解压到路径较短的位置,例如 C:\neo4j,避免后续路径过长导致问题。
启动服务
为了便于管理,我们将其注册为 Windows 服务。
- 管理员权限:搜索 cmd,右键选择'以管理员身份运行'。
- 定位目录:进入 bin 文件夹,例如
cd C:\neo4j\neo4j-community-5.26.13\bin。 - 安装服务:执行
neo4j.bat windows-service install(Neo4j 5+ 版本)。成功会有提示。 - 启动服务:运行
neo4j.bat start。 - 检查状态:输入
neo4j.bat status,看到 "Neo4j is running" 即表示成功。
访问与管理
浏览器访问 http://localhost:7474。首次登录默认用户名为 neo4j,密码也是 neo4j。登录后系统会强制要求修改密码,设置新密码后即可进入主界面。
基本操作
在查询框中尝试创建节点和关系,验证环境是否正常:
// 创建示例数据
CREATE (alice:Person {name: 'Alice', age: 30})
CREATE (bob:Person {name: 'Bob', age: 25})
CREATE (charlie:Person {name: 'Charlie', age: 35})
CREATE (alice)-[:KNOWS]->(bob)
CREATE (bob)-[:KNOWS]->(charlie)
CREATE (alice)-[:KNOWS]->(charlie)
执行查询语句查看可视化结果:
MATCH (n:Person)-[r:KNOWS]->(m:Person) RETURN n, r, m
常用命令
- 停止服务:
neo4j.bat stop - 重启服务:
neo4j.bat restart - 卸载服务:
neo4j.bat windows-service uninstall
配置文件
主要配置位于 conf\neo4j.conf。如需修改端口(默认 7474),可调整 server.http.listen_address。修改后记得重启服务生效。
常见问题
端口被占用
如果 7474 端口冲突,可使用 netstat -ano | findstr :7474 查找占用进程并关闭,或直接修改配置文件中的端口号。
Java 版本不匹配 务必核对 Neo4j 版本与 JDK 版本的对应关系,5.x 版本通常需要 JDK 17+。
服务启动失败
检查日志文件 logs\neo4j.log,常见原因包括权限不足、端口冲突或 Java 环境问题。
总结
至此,Neo4j 在 Windows 上的安装与基础配置已完成。通过 Web 界面和 Cypher 语言,你可以直观地构建和分析关系数据。无论是社交网络分析还是知识图谱,Neo4j 都能提供高效支持。注意定期备份数据,并根据实际需求调整系统资源配置。


