简介：这是一份面向Windows用户的Neo4j社区版5.26.0安装包，适合开发者、数据工程师与知识图谱爱好者在本机快速搭建图形数据库环境。Neo4j以节点和关系存储数据，在社交网络、推荐系统、网络拓扑与知识图谱等复杂关联场景中优势明显；社区版免费且功能完整，足够用于学习、原型验证和非生产环境。压缩包共273个文件，以245个jar组件为主，另含bat启动脚本、conf配置文件、ps1管理脚本、exe服务程序及txt说明文档等，整体大小约151.45MB。其中cypher-shell.bat、neo4j-admin.bat等可直接支撑Cypher查询与数据库管理，neo4j-browser-5.26.0.jar提供可视化操作界面。资源包解压后可快速启动服务，内置Web管理界面，并配套多种驱动与API，便于在Java、Python等语言中调用。已有1146人学习下载，适合需要本地部署图形数据库、学习Cypher语法或开展图数据项目的Windows用户。
1. neo4j-community-5.26.0-windows 是什么：一个解压就能跑的社区版图数据库
拿到neo4j-community-5.26.0-windows这个包名，第一时间就该明白：它不是安装器，而是一个可以在 Windows 上直接解压运行的 Neo4j 社区版压缩包。解压、配好 JDK、改一行监听地址，它就能把知识图谱、关系遍历这套能力跑起来；但跳过环境准备直接点开，大概率会在启动窗口一闪而过、7474 端口打不开之间反复横跳。这篇按我自己的部署习惯，把安装、调优、导入数据、排查坑串成一条能照做的路径。适合要做知识图谱原型、课程设计，或者只想在本地调试 Cypher 语句的开发者。
2. 安装前的三道门槛：JDK 17、JAVA_HOME 与目录解析
Neo4j 从 5.x 开始把运行基线提到了 Java 17，这和 4.x 时代用 JDK 11 的习惯完全是两码事。网上搜 neo4j 安装教程，很多教程还停留在旧版本语法，照着敲就会出现启动窗口一闪而过、日志里报UnsupportedClassVersionError的结果。所以装这个包之前，先把环境门槛一次性理清，后面启动才会顺畅。
2.1 为什么 5.x 社区版必须配 JDK 17
Neo4j 5.x 的启动脚本在检测到 Java 版本不是 17 时会直接拒绝运行。常见的现象是：在 PowerShell 里执行neo4j.bat console，窗口弹出来不到一秒就关闭，什么报错都看不到；或者日志里写着Unsupported major.minor version。这就是当前系统里装的是 JDK 8 或 JDK 11，而程序是按 Java 17 编译的。
解决路径很直接：装一个 OpenJDK 17 发行版，比如 Adoptium Temurin。安装时注意两点：一是安装目录不要带空格，二是要手动配置环境变量，不能只靠安装器自动写注册表。下载完先确认版本能识别：
java -version期望输出里能看到openjdk version "17.0.x"。如果输出是 1.8 或者 11，那就说明JAVA_HOME没指对，或者PATH里排在前面的还是旧 JDK。检查JAVA_HOME指向：
echo $env:JAVA_HOME如果这个变量为空，或者指向了旧版 JDK 的路径，就在管理员 PowerShell 里重新指定，注意把版本号换成你实际下载的目录名：
[Environment]::SetEnvironmentVariable('JAVA_HOME', 'D:\Program Files\Eclipse Adoptium\jdk-17.0.11.9-hotspot', 'User') $env:JAVA_HOME = 'D:\Program Files\Eclipse Adoptium\jdk-17.0.11.9-hotspot' $env:PATH = "$env:JAVA_HOME\bin;$env:PATH"这里第一行把 JDK 路径写进用户级环境变量，第二行只对当前 PowerShell 会话生效，第三行把java.exe所在目录塞到PATH最前面。这样设置是有意的：用户级变量保证以后新开的终端都能读到，会话级变量保证当前窗口马上能用。注意别把JAVA_HOME指到bin目录里，脚本需要的是 JDK 根目录。这一步做完再跑java -version，确保输出版本号是 17 开头，再进入下一步。
2.2 解压 zip，认清 bin、conf、data、plugins 的职责
neo4j-community-5.26.0-windows是 zip 压缩包，不需要安装向导，解压即是安装。但解压路径有讲究。我一般不放C:\Program Files这种带空格且权限受限的目录，而是直接放盘符根路径，比如D:\neo4j。原因是 Windows 下权限问题会以很隐蔽的方式出现，比如写日志失败、数据文件无法锁定时服务静默退出。
在 PowerShell 里执行：
Expand-Archive -Path .\neo4j-community-5.26.0-windows.zip -DestinationPath D:\neo4j解压完成后目录结构是这样分布的：bin下是neo4j.bat、neo4j-admin.bat、neo4j-service.bat三个核心脚本；conf下是neo4j.conf配置文件，所有内存、端口、认证开关都写在这里；data是数据库文件的默认存放位置，包含databases、transactions、logs三个子目录；plugins用来放 APOC 这类扩展 jar 包；import目录是LOAD CSV导入文件的默认根路径。
这份目录结构不是随便分的。data和conf决定了升级时能不能无损迁移，plugins的版本兼容性直接关系到你能不能调用存储过程。社区版想要跑得顺手，应该从解压那一刻就把D:\neo4j\data当成需要备份的资产，而不是把整个 Neo4j 安装目录都备份一遍——安装目录可能因为版本升级被整体替换，但数据目录是你自己的。
2.3 设置 NEO4J_HOME 并用 console 模式验证安装
虽然neo4j.bat不强制要求NEO4J_HOME环境变量，但我建议还是显式设上。因为后续的备份、导入命令、以及把服务注册成 Windows 服务时，脚本会通过这个变量查找路径；一旦缺失，某些操作会退回到脚本所在目录的相对路径计算，在命令行工具和 Windows 服务之间切换时很容易出现路径错乱。
设置和验证：
$env:NEO4J_HOME = 'D:\neo4j' [Environment]::SetEnvironmentVariable('NEO4J_HOME', 'D:\neo4j', 'User')接着用前台模式启动，这是验证安装是否成功最直接的方式，所有启动日志直接打在终端里，任何报错都藏不住：
D:\neo4j\bin\neo4j.bat console看到日志里出现Remote interface available at http://localhost:7474/说明启动成功，终端保持这个窗口别关，打开浏览器访问http://localhost:7474。第一次登录用默认账号neo4j、密码neo4j，系统会强制要求改密码。如果命令窗口里出现一长串堆栈、或者提示Neo4j cannot start，不要慌，把窗口滚动条往上拉，真正的报错信息通常在堆栈的第一屏。这里的关键是：console 模式是给首次启动和对配置做验证用的，生产环境不要用它，后面第 6 章会讲正确的常驻方式。
3. 改 neo4j.conf 让内存和端口按你的机器走：三个必改参数
启动成功只是第一步，Neo4j 默认配置是为“能跑起来”设计的，不是为“跑得舒服”设计的。社区版在 Windows 上的日常体验差距，多半出在内存分配和监听地址这两块。conf\neo4j.conf是纯文本文件，用任意编辑器打开，注意不要用记事本保存成带 BOM 的 UTF-8 编码，否则某些配置项会被解析成乱码然后被忽略。
3.1 内存参数：heap 与 pagecache 的分配逻辑
Neo4j 5.x 的内存配置项和 4.x 不一样，dbms.memory.heap.initial_size这类旧写法在 5.26 里已经不认了，写错配置项会导致启动失败，或者启动时打一条警告后按默认值运行。正确的两个核心配置是：
server.memory.heap.initial_size=1g server.memory.heap.max_size=2g server.memory.pagecache.size=1gheap.initial_size是 JVM 堆的初始大小，heap.max_size是上限。这两个值不要设成一样大，留出一点弹性让 JVM 自己根据负载伸缩；pagecache.size是 Neo4j 自己管理的页缓存，专门缓存节点、关系、属性在磁盘上的数据页，和 JVM 堆是两套独立的内存池。
分配时先估算数据集大小：如果只是课程设计或原型，全库几百 MB，heap 给1g、pagecache 给512m足够；如果要导入几千万节点，heap 建议上限4g，pagecache 给到数据集大小的 25% 到 50%。注意一个常见误操作：把 heap 和 pagecache 相加接近物理内存总量，结果 Windows 上 Neo4j 跑到一半进程被系统杀掉，日志里什么都没有。JVM 本身还要用一部分内存跑类加载和线程栈，我一般会让 heap 加 pagecache 不超过物理内存的 70%，留出系统余量。
还需要理解一个 Windows 特性：Neo4j 的 JVM 堆是进程内分配，pagecache 也是进程内映射，两者叠加就是任务管理器里看到的那个进程占用值。所以不要因为在任务管理器里看到内存占用高就调低 pagecache，先算清楚两个配置项之和是否合理。修改后必须完整重启进程，不是重载，是停掉再启动。
3.2 监听地址与 Windows 防火墙：解决“不能用 IP 访问”
Neo4j 默认只监听localhost，这在本地开发没问题，但很多人换了 IP 访问7474端口连不上，就卡在这里。要允许局域网其他机器访问，需要改一行配置：
server.default_listen_address=0.0.0.0 server.http.listen.address=0.0.0.0:7474 server.bolt.listen.address=0.0.0.0:7687server.default_listen_address是全局默认监听地址，改成0.0.0.0表示监听所有网卡；server.http.listen.address和server.bolt.listen.address是 HTTP 和 Bolt 协议的单独监听地址，按需覆盖。Bolt 是 Neo4j 的二进制协议，驱动程序连接走的是这个端口，所以改 IP 访问时两个端口都得放开，只开 7474 会导致连接工具能打开网页却连不上数据库。
改完监听地址还差最后一步：Windows 防火墙入站规则。常见做法是在管理员 PowerShell 里执行：
New-NetFirewallRule -DisplayName "Neo4j HTTP" -Direction Inbound -Protocol TCP -LocalPort 7474 -Action Allow New-NetFirewallRule -DisplayName "Neo4j Bolt" -Direction Inbound -Protocol TCP -LocalPort 7687 -Action Allow这两条命令分别放行 7474 和 7687 的入站 TCP 连接。如果客户端还是连不上，用netstat -ano | findstr 7474确认 Neo4j 进程确实在监听0.0.0.0:7474而非127.0.0.1:7474，如果输出的是127.0.0.1，说明配置文件没生效，回 3.1 检查重启步骤。
3.3 认证开关与并发线程：少走两步冤枉路
dbms.security.auth_enabled=true是默认开启的，第一次登录后强制改密码，这是合理的默认行为。但有些人图省事把它改成false，局域网里裸奔几个月后数据被删了再来问原因。我的建议是保持开启，连接串里带账号密码是 Neo4j 驱动的标准用法，没有任何负担。
真正的坑在另一个地方：Windows 上 Neo4j 默认线程池配置比较保守，server.bolt.thread_pool_max_size默认值在面对并发写入时会成为瓶颈。社区版单实例场景下，调到 400 左右能明显改善批量导入时的吞吐：
server.bolt.thread_pool_max_size=400这个参数不是越大越好。它决定的是 Bolt 工作线程池上限，每个线程对应一个 JVM 线程，开太多会加剧 GC 压力。如果是单用户调试场景，默认值完全够用。我一般只在用neo4j-admin做大批量导入或者跑多路并行查询时才把它拉高，跑完就调回来。
4. 启动与连接排查：Windows 下最常见的 5 个坑
装了 Neo4j 社区版的人有一半的时间耗在“启动不了”和“连不上”上。这里按我踩过的顺序列出来，每个都按现象、原因、解决三步走，后面照着排查比乱翻日志高效得多。
4.1 双击 bat 一闪而过，数据库像黑匣子一样没反应
现象：在资源管理器里双击neo4j.bat，黑色窗口闪一下就消失了，浏览器访问7474无响应。原因：控制台模式（console）的启动信息没有机会停留在屏幕上，任何 JVM 启动错误都会被窗口关闭吞掉。解决：不要双击，打开 PowerShell 后执行：
D:\neo4j\bin\neo4j.bat console这时所有错误会打印在终端里。最常见的两行是JAVA_HOME is not defined correctly和Unsupported major.minor version，前者回查第 2.1 节的环境变量，后者说明当前JAVA_HOME指向了 JDK 8 或 11。也可以用重定向把输出写到文件里：
D:\neo4j\bin\neo4j.bat console *> D:\neo4j\logs\start_error.log这种方式能保留完整堆栈，适合日志内容太长一屏放不下的情形。
4.2 JAVA_HOME 指向了 JDK 8 或 11，服务进程根本没起来
现象：neo4j.bat console执行后终端没输出任何内容，但进程管理器里也没有 java 进程。原因：脚本里JAVA_HOME解析到的java.exe版本不对，启动脚本在版本检测阶段就退出了，不会打印堆栈。解决：先跑java -version看默认版本，再跑echo $env:JAVA_HOME看变量指向。如果两个输出对不上，说明PATH里先于JAVA_HOME找到了别的 Java 可执行文件。修正方式是在 PowerShell 启动 Neo4j 前临时指定：
$env:JAVA_HOME = 'D:\Program Files\Eclipse Adoptium\jdk-17.0.11.9-hotplug' $env:PATH = "$env:JAVA_HOME\bin;$env:PATH"注意：设置完这两个变量之后，要在同一个终端窗口启动 Neo4j，因为环境变量只对当前进程和它启动的子进程生效。
4.3 改了配置文件内存却没生效
现象：neo4j.conf里把server.memory.heap.max_size改成 4g，:sysinfo查出来还是 512m。原因：Neo4j 启动时读取的是进程工作目录下的conf\neo4j.conf，如果之前有服务已经在跑，修改是在旧进程上做的，重启没做干净；另一个可能是编辑器保存成了 UTF-8 with BOM，第一行配置项被解析成乱码被忽略。解决：确认没有残留进程：
netstat -ano | findstr 7474如果有监听进程，先停掉。然后删掉残缺的data\databases下的锁文件（注意是停服务之后），再启动。验配置是否生效，在浏览器里执行:sysinfo看 JVM heap 和 pagecache 实际值，或打开logs\neo4j.log搜heap.max。这一步是治内存配置“改了没反应”这类玄学问题的标准手段。
4.4 换了本机 IP 访问 7474 连不上
现象：http://localhost:7474正常，换成http://192.168.x.x:7474打不开页面。原因：server.default_listen_address默认值是localhost，所以服务只绑在回环地址上，不接收外部网卡流量。解决：按第 3.2 节改监听地址，重启后用netstat -ano | findstr 7474确认监听地址是0.0.0.0。同时检查 Windows 防火墙入站规则，这一步是新手最容易漏的：改完配置、重启完进程，但防火墙没放行，外部访问仍然超时。可以临时关防火墙测一把来确认是不是这个原因，但测完必须把防火墙开回来，用放行规则而不是关闭防火墙来解决。
4.5 console 窗口一关，数据库跟着停
现象：用neo4j.bat console启动后一切正常，但把终端窗口关掉，数据库就停了，浏览器立刻连不上。原因：console 模式是前台模式，进程的生命周期挂在终端上，终端关闭时系统会向子进程发送终止信号。解决：开发调试用 console 没问题，但真正要长时间跑，应该以后台服务方式运行。常见做法是把 Neo4j 注册成 Windows 服务，具体步骤在第 6 章。这里想强调的是：很多人用了一个月的 console 模式，电脑重启或误关窗口导致数据写入中断，日志里出现恢复记录，实际上就是没有切换到服务模式带来的风险。
5. 导入数据与多路径查询：LOAD CSV 的路径坑和两跳遍历写法
社区版装好、配好之后，真正让 Neo4j 发挥价值的动作是导入数据和写查询。很多教程在这一步教的是CREATE语句一条条建节点，那不是导入，那是演示。真实业务数据在 CSV 里，用LOAD CSV批量导入才是正路。
5.1 把 CSV 放进 import 目录：路径写法与批量参数
Neo4j 默认只允许从import目录读本地 CSV 文件，这是安全限制，防止 Cypher 查询任意读取服务器文件。把D:\neo4j\import当成数据文件的唯一入口，比如准备一份persons.csv，表头是id,name,age。最常见的报错是：
Couldn't load the external resource at: file:///D:/neo4j/import/persons.csv原因基本是路径分隔符写成了反斜杠，或者文件不在 import 目录下。正确写法是正斜杠，并且用file:///开头（三个斜杠）：
USING PERIODIC COMMIT 500 LOAD CSV WITH HEADERS FROM 'file:///persons.csv' AS row CREATE (:Person {id: row.id, name: row.name, age: toInteger(row.age)});这个语句的要点有三个。第一：USING PERIODIC COMMIT 500是批量提交控制，每处理 500 行提交一次事务，避免几万条数据攒在一个大事务里把内存打爆；第二：row.id、row.name对应 CSV 表头里的列名，字段名拼错会得到null而不是报错，所以导入后先数一遍节点数量和属性完整性；第三：toInteger(row.age)是因为 CSV 读进来的值全是字符串，需要显式转换类型。
导入前先建唯一约束，防止重复数据插入：
CREATE CONSTRAINT person_id_unique FOR (p:Person) REQUIRE p.id IS UNIQUE;带约束的导入天然承担了去重职责：违反唯一约束的行会让整个 PERIODIC COMMIT 批次失败，日志里会明确告诉你哪一行冲突。这个特性在构建知识图谱时特别有用，人物、公司、地点这些实体都需要唯一的业务主键，不能依赖 Neo4j 内部生成的节点 ID 去重。数据量再大一些，比如单文件超过 500 万行，建议改用neo4j-admin database import做离线导入，那种方式绕过了事务日志，速度是LOAD CSV的十倍以上，但要停库操作，不适合联机环境。
5.2 从一个节点出发查多条路径：可变长关系与 UNION 的取舍
导入完数据之后，最常被问到的一个问题是：从一个节点出发，怎么把它的直接关系和间接关系一次查出来。比如给定一个人，想同时拿到他的好友列表、好友的好友列表。用可变长关系是最简洁的写法：
MATCH (start:Person {name: '张三'})-[:KNOWS*1..2]-(target:Person) WHERE target.name <> '张三' RETURN DISTINCT target.name AS name, start.name AS startName ORDER BY name LIMIT 50;[:KNOWS*1..2]表示关系长度从 1 到 2 跳，DISTINCT去掉因为在两跳路径里出现重复的中间人，target.name <> '张三'排除掉从环上绕回起点的情况。这个查询的执行逻辑是：先定位start节点，沿KNOWS关系扩展一跳得到直接好友，再扩展一跳得到间接好友，最后去重排序。
但可变长关系有个性能隐患：*1..2的 2 还好，如果写成*1..6，路径数量随深度指数膨胀，很容易把堆内存打完。我自己的习惯是：两跳以内用可变长关系，超过两跳就拆开写：
MATCH (start:Person {name: '张三'})-[:KNOWS]->(direct:Person) OPTIONAL MATCH (direct)-[:KNOWS]->(indirect:Person) WHERE indirect IS NULL OR indirect.name <> '张三' RETURN collect(DISTINCT direct.name) AS directFriends, collect(DISTINCT indirect.name) AS secondDegreeFriends;这个写法用了OPTIONAL MATCH保留没有二度关系的好友，再用collect(DISTINCT ...)聚合成两个列表，结果是一行两条。性能上比*1..2更可控，因为它把两跳拆成两个独立的匹配阶段，优化器可以分别做剪枝。
如果还要额外区分“直接好友”和“二度好友”，用UNION把两个查询合并：
MATCH (start:Person {name: '张三'})-[:KNOWS]->(b:Person) RETURN b.name AS name, '直接好友' AS hopType UNION MATCH (start:Person {name: '张三'})-[:KNOWS]->()-[:KNOWS]->(b:Person) WHERE NOT (start)-[:KNOWS]->(b) RETURN b.name AS name, '二度好友' AS hopType;UNION会自动去重，所以第二个查询里要手动排除掉也是直接好友的人，否则二度好友列表里会混入直接好友。想保留重复记录就用UNION ALL。这三种写法覆盖了“从一个节点出发查多条”的大部分场景：要看所有可达节点用可变长，要分层次聚合用OPTIONAL MATCH，要打标签区分层级用UNION。知道区别后按需选，不用每种都背。
6. 注册成 Windows 服务并做备份验证：把 Neo4j 固定下来
6.1 用 neo4j-service 安装服务
console 模式适合调试，不适合长期运行。Neo4j 官方在bin下提供了neo4j-service.bat，专门用于把 Neo4j 注册成 Windows 服务。以管理员身份打开 PowerShell：
D:\neo4j\bin\neo4j-service.bat install安装成功后启动服务：
net start neo4j服务启动后不需要打开任何窗口，进程在后台常驻，电脑重启后也会自动拉起。卸载时先停止服务再执行neo4j-service.bat uninstall。注意：注册服务前先把第 3 章的内存和监听配置改好，有些配置调整需要在服务注册后重启才生效，如果装完才发现配置不对，用neo4j-service.bat restart重启。
6.2 备份与验证命令
服务跑起来后的第一件事，不是继续写查询，而是确认备份通路是好的。Neo4j 的数据备份不能用 Windows 文件复制，直接拷贝data\databases目录容易在事务日志未回放时产生不一致快照，正确做法是用neo4j-admin。先停服务，再执行离线备份：
net stop neo4j D:\neo4j\bin\neo4j-admin.bat database dump neo4j --to-path=D:\neo4j\backup net start neo4j备份完成后D:\neo4j\backup下会有一个neo4j.dump文件。验证备份是否有效，最稳妥的方式是临时改一个数据库名导入到另一套环境里测试。这个习惯不太好坚持，但真到数据被误删的时候，它就是唯一的后悔药。连接验证方面，浏览器打开http://localhost:7474，执行SHOW DATABASES;看当前库状态，执行:sysinfo看 JVM 内存实际值和版本号。这两条命令每次启动后看一眼，基本就能确认整个部署链路是健康的。
服务注册加备份这套组合拳，是我在 Windows 上部署 Neo4j 社区版最后一步固定动作：先把服务注册成常驻进程，再做一次完整备份验证，最后才放心让业务往里写数据。早期我也跳过备份直接开发，直到一次误操作删掉了整个测试库，重建花了大半天，从那以后备份验证就没断过。希望这些步骤能帮你把 Neo4j 在 Windows 上稳定跑起来，省掉那些不必要的折腾。
本文还有配套的精品资源，点击获取
