简介：这是一份面向Windows平台的Neo4j社区版5.26.0图形数据库安装资源，适合需要处理社交网络、推荐系统、知识图谱、金融风控等复杂关联数据的开发者、学习者和初创团队。该版本提供基于节点与关系的建模方式，不同于传统关系型数据库的表结构，能更直接地表达实体间的联系，适合本地搭建环境、验证图数据模型和练习查询语法。压缩包共273个文件，大小约151.48MB，其中绝大多数为Java类库文件，还包含服务启动脚本、配置模板、系统服务程序及证书许可文件，覆盖从安装、启动、配置到客户端访问的完整组件，便于快速部署。目前已有1229人浏览学习，常被作为入门图形数据库的参考资料。使用时可借助图形化客户端观察节点和关系的整体结构，结合声明式查询语言完成节点创建、关系匹配、路径查找等操作；同时可通过配置文件调整内存与存储参数，进行简单性能调优。社区版免费授权，没有商业许可成本，适合个人学习、课程实验和小型项目预研。
1. 拿到 neo4j-community-5.26.0-windows.zip 后，第一步千万别双击
刚把这个 zip 解压完，很多人会习惯性去 bin 目录双击 neo4j.bat，结果黑色窗口一闪就没了。这不是你的电脑有问题，而是没搞清楚社区版的启动方式。neo4j-community-5.26.0-windows.zip 是 Neo4j 5.26.0 社区版在 Windows 上的免安装压缩包，它把数据库引擎、CLI 工具、默认配置都塞在一个 zip 里，不带图形安装向导，也不会自动注册系统服务。它解决的具体诉求是：在没有管理员权限、不想装桌面版的机器上，快速得到一个可用的图数据库，用来做本地开发、爬虫数据落库、知识图谱原型验证。适合两类人——被网上各类安装教程绕晕的入门者，以及要在内网 Windows 服务器上部署社区版的一线开发。这篇笔记就把这个 zip 从解压到稳定运行的全过程讲透。
2. Neo4j 5.26.0 社区版为什么是“zip 包 + 命令行”的形态？
2.1 Neo4j 5.x 的架构变化：从嵌入式到服务器化
Neo4j 从 4.0 开始把架构彻底改了一遍，到了 5.26.0 这一代，它的定位已经非常清晰：一个独立的图数据库服务器，客户端通过 Bolt 协议（默认端口 7687）和 HTTP 协议（默认端口 7474）访问，不再鼓励在业务进程里嵌一个数据库实例。这在 Windows 上的直接后果就是——你需要手动把它启动起来，而不是靠安装包帮你拉起一切。
zip 包的目录结构值得先看一遍，后面所有排错都围绕这几个目录：
| 目录 | 作用 | 使用频率 |
|---|---|---|
| bin | neo4j.bat、neo4j-admin.bat、cypher-shell.bat 等命令行工具 | 每次操作都用到 |
| conf | neo4j.conf 核心配置文件 | 修改配置时进入 |
| data | databases 子目录存放图数据，dbms.auth 存放认证信息 | 备份和重置时进入 |
| logs | neo4j.log、debug.log、http.log | 出问题时第一个看这里 |
| plugins | 自定义过程和插件 | 装 APOC 等扩展时用 |
| import | LOAD CSV 的默认文件目录 | 数据导入时用 |
| lib | Java 依赖库 | 基本不用动 |
5.x 的配置项命名也变了，老教程里到处都是 dbms.memory.heap.max_size、dbms.connector.http.listen_address 这种写法，在 5.26.0 里基本都失效了，统一改成了 server.memory.* 和 server.*.listen_address。后面配置章节会具体讲，这里先记住一个原则：凡是看到 dbms. 开头的配置，先怀疑是过时的 3.x/4.x 写法，去官方文档核对 5.x 的对应字段。
2.2 社区版和企业版的边界：哪些能玩，哪些是坑
标题里写着 “community”，就必须说清楚社区版和企业版的差异，否则你会在某个功能上找半天才发现是版本限制。
| 能力 | 社区版 | 企业版 |
|---|---|---|
| 授权模式 | GPLv3 免费 | 商业订阅 |
| 多数据库 | 支持 | 支持 |
| 在线备份 | 不支持，只能离线 dump | 支持热备份 |
| 集群与高可用 | 不支持 | 支持因果集群 |
| 用户权限管理 | 仅有基础密码认证 | 支持 RBAC、LDAP、SSO |
| 监控与管理工具 | 无 | 集成在运维体系中 |
社区版在 Windows 单机上的实际经验是：如果你只是做知识图谱原型、本地开发、中小规模数据验证，它的能力完全够用。我自己建的几千个节点、几万条关系的图，社区版跑起来没有任何压力。但要注意两个硬伤——第一，没有在线备份，备份时数据库必须停掉或用 neo4j-admin dump 冷备；第二，用户权限只有一层密码保护，不能用角色把不同团队的访问范围隔开。这些在设计部署方案时就要提前想好。
2.3 前置条件：JDK 17 和 JAVA_HOME，差一步都起不来
Neo4j 5.26.0 要求 JDK 17 运行环境，这不是玄学，是编译期就定死的规矩。我在 Windows 上第一次装的时候，机器上装的是 JDK 8，双击 neo4j.bat 后窗口闪一下就没有然后了，排错排了半小时才发现是 JAVA_HOME 指错了版本。
检查命令很简单，打开 CMD 输入：
java -version如果输出里没有 “17” 这个字样，就需要装 JDK 17。装完后一定要配 JAVA_HOME 环境变量：
JAVA_HOME=C:\Program Files\Eclipse Adoptium\jdk-17.0.10.7-hotspot在系统环境变量里新建 JAVA_HOME，指向 JDK 根目录而不是 jre 目录，然后把 %JAVA_HOME%\bin 加到 Path 变量最前面。这里有个非常普遍的误操作：装了 JDK 也配了 JAVA_HOME，但 Path 里还残留着旧版 JDK 的路径，导致 java -version 仍旧显示旧版本。解决方法是把 Path 里所有 Java 相关路径删掉，只保留 %JAVA_HOME%\bin 这一条，重新开一个 CMD 窗口再验证。
3. 用 neo4j 命令在本地跑通 5.26.0：最小启动步骤与三个必调参数
3.1 首次启动：neo4j console 前台运行
解压 zip 时我一般用 7-Zip，Windows 自带的“全部解压缩”虽然也能用，但在路径较长或含特殊字符时偶尔会解压不完整。解压完成后把目录放在纯英文路径下，比如 D:\neo4j-community-5.26.0，避免中文路径带来编码问题。
打开 CMD，进入 bin 目录，运行前台启动命令：
cd D:\neo4j-community-5.26.0\bin neo4j console看到控制台输出 “Started.” 或者 “Remote interface available at http://localhost:7474” 这样的日志，就说明数据库起来了。这时打开浏览器访问 http://localhost:7474 ，Neo4j Browser 会要求登录。默认用户名是 neo4j，初始密码也是 neo4j，首次登录会强制要求你修改密码。
为什么推荐先用 console 方式而不是直接安装成服务？因为 console 模式把启动日志直接打在屏幕上，第一次跑起来时如果有配置错误、端口冲突、JDK 版本不对，你能立刻看到报错信息。我之前图省事，上来就 neo4j start，结果数据库没起来，日志又写到 logs 目录里，排查起来反而多绕一圈。
启动失败时先别慌，看屏幕上的错误提示，最常见的三种：
| 报错信息 | 原因 | 处理方式 |
|---|---|---|
| Java was not found | JAVA_HOME 未配置 | 检查 JDK 安装和 PATH |
| Address already in use | 7474 或 7687 端口被占用 | 用 netstat -ano | findstr 7474 查占用 |
| dbms was not correctly shutdown | 上次异常退出 | 删除 data/databases 下对应库的锁文件 |
3.2 验证端口与连接：cypher-shell 快速体检
浏览器能打开只说明 HTTP 端口正常，Bolt 端口有没有通，得用客户端连一下才知道。Neo4j 自带 cypher-shell 工具，就在 bin 目录下。另开一个 CMD，执行：
cd D:\neo4j-community-5.26.0\bin cypher-shell -u neo4j -p "你修改后的密码"进入 shell 后输入一句最简单的查询验证连通性：
RETURN 1 AS test;如果返回 test = 1，说明 Bolt 端口 7687 工作正常。这一步很重要，因为你后面用 Java、Python 驱动连 Neo4j 时，走的都是 Bolt 而不是 HTTP。我在排查时经常遇到浏览器能登录但程序连不上的情况，八成是防火墙拦了 7687 端口，而浏览器走的 7474 恰好放行了。
3.3 三个必调参数：内存、监听地址、导入目录
数据库能跑起来只是第一步，让它稳定高效地跑需要动 conf/neo4j.conf。用记事本或 VS Code 打开这个文件，找到以下配置项：
# JVM 堆内存 server.memory.heap.initial_size=512m server.memory.heap.max_size=2G # 页缓存，直接管理磁盘映射 server.memory.pagecache.size=1G # 监听地址 server.default_listen_address=127.0.0.1 # HTTP 与 Bolt 端口 server.http.listen_address=:7474 server.bolt.listen_address=:7687参数说明与建议值：
| 参数 | 作用 | 建议值 |
|---|---|---|
| server.memory.heap.initial_size | JVM 堆初始大小 | 物理内存的 1/4 左右 |
| server.memory.heap.max_size | JVM 堆上限 | 不超过物理内存的 1/2 |
| server.memory.pagecache.size | 图数据页缓存，直接影响磁盘 IO | 物理内存的 1/4 到 1/2 |
| server.default_listen_address | 所有监听地址的默认值 | 本机调试用 127.0.0.1，局域网访问改 0.0.0.0 |
一台 8G 内存的 Windows 机器，我一般给堆 2G、pagecache 1G、系统留 4G 左右。这个比例不是拍脑袋，Neo4j 的 pagecache 走内存映射文件，给的太少会频繁触发磁盘读写，给得太多又和操作系统抢内存导致换页。如果你发现 Neo4j 明明按照网上教程改了内存配置却没生效，十有八九是改成了 dbms.memory.* 开头的旧字段，5.x 只认 server.memory.*，这是配置体系换代的典型翻车点。
3.4 常驻运行：install-service 把它变成 Windows 服务
console 模式有个明显短板：窗口关掉进程就没了。想让 Neo4j 开机自启、崩溃后由 Windows 服务管理器拉起，就需要把它注册成服务。这一步需要管理员权限，在 CMD 里右键“以管理员身份运行”，然后：
cd D:\neo4j-community-5.26.0\bin neo4j install-service neo4j startneo4j start 返回后，用 neo4j status 查看运行状态。如果显示 Neo4j is running，说明服务注册成功。以后开机 Windows 会自动拉起这个服务，日常维护用 neo4j stop 和 neo4j restart 控制。要注意的是，修改 neo4j.conf 里的内存或监听配置后，必须 neo4j restart 让配置重新加载，光改文件不重启是无效的，这个我踩过不止一次。
4. 把数据灌进 Neo4j：从 CSV 到知识图谱的三条路线
4.1 先想清楚模型：节点、关系、属性
知识图谱的核心不是把数据堆进数据库，而是先定义清楚图模型。Neo4j 的图模型只有三种元素：节点、关系、属性。节点用标签（Label）区分类型，比如 Person、Company；关系用类型（TYPE）表示语义，比如 WORKS_AT、FRIEND_OF。属性就是键值对。
建模这一步没想清楚，后面导入多少数据都是白费。我的习惯是先在白纸上画一遍实体关系图，确定哪些实体是节点、哪些联系是需要带属性的关系，然后再动手写导入脚本。关系本身的属性也很重要，比如“入职时间”“合作时长”这类信息应该挂在关系上，而不是塞进节点里。
4.2 路线一：Cypher 手工创建小规模数据
数据量在几百条以内时，直接用 Cypher 手工建图最快。比如构建一个“张三在北京知识图谱科技工作”的图：
CREATE (p:Person {id: 'p001', name: '张三'}) CREATE (c:Company {id: 'c001', name: '北京知识图谱科技'}) CREATE (p)-[:WORKS_AT {since: 2020}]->(c);CREATE 是无条件创建，每次执行都会新建节点，重复执行会产生重复数据。如果是脚本反复运行，建议用 MERGE。MERGE 的行为是先按指定属性查找，找到就返回已有节点，找不到才创建。两者区别就在这——CREATE 适合一次性初始化，MERGE 适合幂等导入。
4.3 路线二：LOAD CSV 运行时导入，百万行以内首选
这是把 CSV 灌进 Neo4j 最常用的方式。把 people.csv 放到 import 目录下，CSV 第一行必须是表头，文件编码必须是 UTF-8，然后在 cypher-shell 或 Neo4j Browser 里执行：
LOAD CSV WITH HEADERS FROM 'file:///people.csv' AS line MERGE (p:Person {id: line.id}) SET p.name = line.name, p.age = line.age;逐行拆解一下：LOAD CSV WITH HEADERS 把第一行当字段名，后续每行通过 line.字段名 访问；MERGE 按 id 属性去重，避免重复导入；SET 把 CSV 里的其他字段写成节点属性。如果你的数据量超过几十万行，建议在 LOAD CSV 前加 USING PERIODIC COMMIT 500，让 Neo4j 每处理 500 行提交一次事务，避免单个大事务撑爆内存。
这里有个文件路径的细节：file:///people.csv 是相对 import 目录的写法。如果 CSV 放在别的目录，必须先在 neo4j.conf 里设置 server.directories.import 指向那个目录，然后用绝对路径访问。否则 Neo4j 会拒绝读取 import 目录之外的文件，这是 5.x 的安全机制。
4.4 路线三：neo4j-admin database import 批量导入，GB 级数据专用
如果你手上有好几 GB 的 CSV，LOAD CSV 逐个事务提交的速度就太慢了。这种场景要用 neo4j-admin 工具做离线批量导入。先停止数据库：
cd D:\neo4j-community-5.26.0\bin neo4j stop然后执行批量导入命令：
neo4j-admin database import full \ --nodes=Person=import\people.csv \ --nodes=Company=import\company.csv \ --relationships=WORKS_AT=import\works_at.csv \ mygraph.db命令里 --nodes 参数指定节点文件和标签，--relationships 指定关系文件，最后一个参数 mygraph.db 是新建的数据库名。关系文件里必须包含 START_ID 和 END_ID 两列，分别对应两个节点文件中的 id 字段。导入完成后，编辑 conf/neo4j.conf，把 server.default_database=mygraph.db 设置成默认数据库，再 neo4j start。
选择哪条路线的判断标准很简单：百万行以内用 LOAD CSV，量再大就用 neo4j-admin import。前者在线处理、灵活可控，后者一次性全量导入、速度极快但必须停库。
4.5 导入时容易翻车的三个细节
第一个坑是 Excel 导出的 CSV 编码问题。Excel 默认用 ANSI/GBK 编码写 CSV，而 Neo4j 只认 UTF-8。用记事本打开 CSV 另存为 UTF-8 能解决，但如果是程序自动生成的 GBK 文件，就得用 PowerShell 转码：
Get-Content people_gbk.csv -Encoding Default | Out-File people_utf8.csv -Encoding utf8第二个坑是 UTF-8 BOM。有些文本编辑器保存 UTF-8 时会在文件开头加上 BOM 标记，导致第一列字段名变成 \ufeffid，MERGE 时匹配不上。用 Notepad++ 打开文件，把编码从“UTF-8-BOM”转成“UTF-8 无 BOM”再重新导入。
第三个坑是 CSV 里字段本身包含逗号或引号。这种字段必须用双引号包裹，否则会把一列拆成两列导致数据错位。写脚本导出 CSV 时，建议用 Python 的 csv 模块而不是自己拼字符串，它能自动处理转义。
5. Neo4j 5.26.0 Windows 安装配置避坑：5 条血泪经验
5.1 neo4j.bat 一闪而过，先查 JAVA_HOME 而不是怀疑包损坏
现象：双击 bin 目录下的 neo4j.bat，黑色窗口一闪就关闭，数据库没有启动。
原因：JAVA_HOME 环境变量未配置，或者配置路径指向了 JRE 而不是完整的 JDK，5.26.0 需要 JDK 17 的编译能力，仅有 JRE 无法启动。
解决：在 CMD 里先执行 java -version 确认版本，再到系统环境变量里检查 JAVA_HOME 是否指向 JDK 17 根目录。另一个排查技巧是不要双击，而是打开 CMD，手动执行 neo4j console，这样错误信息会停留在屏幕上而不是一闪而过，能看到具体的异常堆栈。
5.2 内存配置改了没生效：别再动 wrapper 和 JAVA_OPTS
现象：按网上教程在 neo4j.conf 里把 server.memory.heap.max_size 改成 4G，重启后查看日志，堆内存还是默认的 2G，或者直接报启动失败。
原因：5.x 版本统一从 neo4j.conf 读取 JVM 参数，旧版本的 wrapper-java-options.conf、JAVA_OPTS 环境变量、dbms.memory.heap.max_size 这些字段都已经被废弃。教程找的是 3.x 的老文章，配置字段名不匹配，Neo4j 直接忽略。
解决：编辑 conf/neo4j.conf，确保以 server.memory. 开头配置，改完必须 neo4j restart。验证是否生效，打开 logs\neo4j.log 搜索 “heap” 关键字，能看到启动时打印的实际堆内存大小，确认与配置一致。
5.3 本机能访问，局域网内其他机器连不上
现象：本机浏览器访问 http://localhost:7474 一切正常，但同网段的其他机器访问 http://192.168.x.x:7474 迟迟打不开，Java 程序通过 Bolt 连接也会超时。
原因：server.default_listen_address 默认是 127.0.0.1，Neo4j 只监听本机回环地址，不会接受外部连接请求。同时 Windows 防火墙默认拦截外部端口访问，两层因素叠加导致外部不可达。
解决：修改 conf/neo4j.conf，把 server.default_listen_address=0.0.0.0，重启服务。然后在管理员 CMD 里放行防火墙端口：
netsh advfirewall firewall add rule name="Neo4j HTTP" dir=in action=allow protocol=TCP localport=7474 netsh advfirewall firewall add rule name="Neo4j Bolt" dir=in action=allow protocol=TCP localport=7687注意一点：改监听地址为 0.0.0.0 后，Neo4j Browser 登录页会暴露在局域网中，生产环境要确认网络隔离，不要随意在公网开放这个端口。
5.4 数据导入到一半中断，数据库起不来了
现象：用 LOAD CSV 导入大批量数据时，或者 neo4j-admin import 执行到一半被 Ctrl+C 中断，之后 neo4j start 提示数据库无法启动或数据文件损坏。
原因：中途中断会导致事务日志和存储文件不一致，Neo4j 启动时会做一致性校验，发现异常就拒绝启动。
解决：LOAAD CSV 导入必须配合 USING PERIODIC COMMIT 分批提交，这样中断只会丢失最近一个批次的数据，不会造成全库损坏。如果是 neo4j-admin import 中断，直接删除刚生成的 mygraph.db 目录，修复数据文件后重新导入。导入前做好数据文件备份，比事后想办法恢复更实际。
5.5 登录密码忘了，别重装，删掉 dbms.auth 就行
现象：首次登录强制修改密码后，隔了几个月没用，密码忘了，登录被拒绝。
原因：Neo4j 的用户认证信息存在 data/dbms.auth 文件里，密码一旦丢失正门进不去。
解决：停掉数据库，删除 data\dbms.auth 文件，重启数据库。启动后用户认证重置为初始状态，用 neo4j / neo4j 登录，并再次设置新密码。这个操作只适用于本地开发环境，生产环境别这么干，正确做法是提前用备份机制保住认证信息。
6. 进阶：从“能跑”到“好用”——服务化、备份与一条查询模板
最后一章聊几个让 Neo4j 在 Windows 上真正好用的收尾操作。第一个是备份。我见过太多人直接复制整个 data 目录当备份，这在 Neo4j 5.x 里不靠谱，运行中的数据库文件处于不断写入状态，直接拷贝容易得到不一致的快照。正确做法是用 dump 命令做离线备份：
cd D:\neo4j-community-5.26.0\bin neo4j stop neo4j-admin database dump mygraph --to=D:\backup neo4j start恢复时把 dump 文件加载回去：
neo4j-admin database load mygraph --from=D:\backup\mygraph.dump备份文件是单个 .dump 文件，方便归档。社区版没有在线备份能力，这个冷备流程虽然要停机，但在开发环境下完全够用。
第二个是查询模板。搜索热词里有一个高频问题——“从一个节点出发如何查询多条路径”。知识图谱里最常见的查询，就是给定一个起点，找出它若干跳范围内的所有关联。这条 Cypher 模板覆盖了大多数场景：
MATCH (p:Person {name: '张三'}) MATCH path = (p)-[:FRIEND|:WORKS_AT*1..3]->(n) RETURN path, n.name, length(path) AS hops LIMIT 200;参数说明：[:FRIEND|:WORKS_AT*1..3] 是变长路径匹配，表示沿 FRIEND 或 WORKS_AT 关系走 1 到 3 跳，| 是关系类型或，*1..3 是跳数范围；length(path) 返回每条路径的跳数。变长路径是图数据库的招牌能力，但性能开销会随跳数指数增长，超过 5 跳响应时间会明显变长。所以这个模板默认限制了跳数上限和返回条数。
最后是我的一个习惯：把启动、导入、备份分别写成三个 .bat 脚本放在项目目录下，需要时直接双击。我在 Windows 上部署 Neo4j 翻过最多的车，不是 Cypher 写错，而是把 zip 解压后就以为装完了。图数据库不像 MySQL 装完就常驻，它默认把控制权交给命令行——你给它一个服务身份、一份合理的配置、一条可靠的备份路径，它才回报你一个稳定的数据层。希望帮到你。
本文还有配套的精品资源，点击获取
