先确认机器条件。我以 Neo4j 5.26.13 为例,它需要 JDK 17;如果你是 4.x,JDK 11 就够了。官方给出的版本对应关系如下:
| Neo4j 版本 | 推荐 JDK 版本 |
|---|---|
| 4.4.46 | JDK 11 |
| 5.26.13 | JDK 17 |
| 2025.09.0 | JDK 21 |
至少 4G 内存和 20G 磁盘,Windows 10/11 64 位。
装 Java 环境
先看看系统里有没有 Java。打开终端,跑一下:
java -version
如果打印出的版本号 ≥11,那就不用再装。否则得去下载 JDK。
我习惯从 Oracle 或 OpenJDK 官网下载。找 JDK 17 的 Windows 安装程序(.exe),直接下载就行。官网页面大概长这样:

双击安装包,一路下一步,默认路径就行。安装程序会自动配好环境变量,不用手动折腾。

安装完成后,打开一个新的命令行,确认版本:

java -version
javac -version

下载与解压 Neo4j
去 Neo4j 部署中心 下载 Community 版压缩包。这里选的是 5+ 版本,所以 JDK 17 是前提。

解压到一个简单路径,比如 C:\neo4j,避免空格或中文。

启动 Neo4j 服务
以管理员身份打开命令行:

切到解压目录的 bin 里:
cd C:\neo4j\neo4j-community-5.26.13\bin
安装服务之前确认 Java 已经就绪。5.x 用这条命令:
neo4j.bat windows-service install
(4.x 版本则是 neo4j.bat install-service)

然后启动:
neo4j.bat start

状态检查用 neo4j.bat status,如果看到 'Neo4j is running' 就说明跑起来了。

访问与初始化
浏览器打开 http://localhost:7474。默认用户名密码都是 neo4j,首次登录会强制要求修改密码。

成功后进入浏览器主界面:

跑几条 Cypher 试试
创建一些示例节点和关系:
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
# 状态
neo4j.bat status
配置文件
主配置文件在 conf\neo4j.conf,修改后需重启服务。
# 端口(默认 7474)
server.http.listen_address=:7474
# 启用 HTTPS
server.https.enabled=true
server.https.listen_address=:7473
# 数据目录
server.directories.data=data
# 日志配置
server.logs.config=conf/user-logs.xml
常见问题
端口占用
如果 7474 被占,要么改上面的端口配置,要么直接干掉占用进程:
netstat -ano | findstr :7474
taskkill /PID 进程PID /F
Java 版本不匹配
对着文章开头的表格检查,5.x 必须 JDK 17+,4.x 用 JDK 11+。
服务启动失败
先看 logs\neo4j.log。通常都是权限不够(需要管理员)、端口冲突或者 Java 环境变量没生效。


