简介面向图数据库学习者与开发运维人员这是一份 Neo4j 5.23.0 社区版 Windows 安装压缩包可离线部署并直接用于本地开发与教学。Neo4j 以节点和关系构成的图模型存储数据可直观表达复杂关联并通过 Cypher 声明式查询语言完成深度关系检索适合社交网络、知识图谱及推荐系统等场景。压缩包共 264 个文件包含 235 个 jar 主程序与依赖库、8 个 txt 文档、6 个 PowerShell 运维脚本、3 个 bat 启停脚本、2 个 conf 配置文件、2 个 exe 系统服务程序及证书、XML 等辅助文件压缩后大小约 119.26MB。包内除 neo4j.bat、neo4j-admin.bat 等管理入口外还提供 cypher-shell.bat 命令行工具、prunsrv 服务注册程序及 Neo4j Browser可快速启动图数据库并可视化查询结果同时包含 neo4j-admin.conf 等配置便于调整内存、端口与认证参数。已有 523 人学习下载。适合希望离线部署图数据库、动手验证 Cypher 语法或搭建小型图计算试验环境的读者。1. 拿到 neo4j-chs-community-5.23.0-windows.zip 之前先搞清它在哪一层neo4j-chs-community-5.23.0-windows.zip 这个名字拆开就是 Neo4j 社区版Community5.23.0 版本Windows 平台zip 格式免安装包chs 一般指简体中文资源包。它不像 Neo4j Desktop 那样要注册登录也不像安装 exe 那样写注册表你下载到的就是一个能解压后直接跑起来的目录。它能解决的是在 Windows 上快速拉起一个单机图数据库用来搭知识图谱、分析关联路径、给业务系统做图谱查询或者当 Neo4j 的本地学习环境。适合谁想从 MySQL 表模型跳出来看关系网络的后端开发、需要离线部署图库的运维以及刚接触 Neo4j 又不想被 Desktop 的工程化包装带偏的菜鸟。后面我会按一个工程包落地的顺序把解压、JDK 17、neo4j.conf、数据导入和那些装完 24 小时内最容易翻车的坑一次讲清。2. 把 zip 变成能跑的图数据库解压、JDK 17 与第一条 console 命令2.1 为什么我选 zip 而不是 Neo4j Desktop第一次用 Neo4j 的人网上搜 neo4j desktop 下载多半会被引导去装桌面版。Desktop 确实把启动、停止和版本切换做成了可视化按钮装完还能看示例项目但它把配置和数据目录包在自己的项目空间里想改neo4j.conf反而要找半天。zip 包的好处是目录结构透明bin、conf、data、logs、import就在一层做脚本化部署和换机器迁移都方便。形态好处代价Neo4j Desktop图形化管版本和插件配置路径被包一层不适合脚本化社区版 zip 解压包目录透明改配置直接需要自己装 JDK 17、自己启停服务安装 exe自带启动器注册表和系统服务残留更重这个 zip 里的chs我按平时给客户打包的习惯理解成简体中文资源解压后中文文档和示例注释会多些但核心引擎和官方发行版一致。你没必要为了中文界面去找奇怪的汉化分支Neo4j 的浏览器界面本身就能正常显示中文标签和属性。2.2 解压到纯英文路径中文目录和 zip 伪加密都要避开我一般用 7-Zip 解压到C:\neo4j。这里有个血泪经验不要解压到C:\Users\张三\桌面这种带中文和空格的路径neo4j.bat内部要做相对路径切换中文和括号有时候会让 PowerShell 解析失败报错还特别隐晦。另外还有一种情况zip 在镜像站转存过双击一直要求密码。先别急着删文件重新下载先怀疑 zip 伪加密。zip 格式里有个加密标志位某些工具只看标志位不看真实加密内容就会弹出密码框用 7-Zip 打开这个 zip 看能不能预览内部目录如果能py通关多半是伪加密换个解压工具就行。解压完确认目录结构完整C:\neo4j ├─ bin neo4j.bat、neo4j-admin.bat、cypher-shell.bat ├─ conf neo4j.conf 在这 ├─ data ├─ imports ├─ logs └─ lib如果bin单独被拖到桌面其它目录没跟上后面启动会各种找不到路径。正确做法是整个 zip 解压到 C 盘根目录不要手动把单个文件拖出来。2.3 先确认 JDK 17否则 console 一秒闪退Neo4j 5.x 要求 JDK 17。很多 Windows 机器上装了 1.8 或 21Neo4j 启动时要么起不来要么日志打到一半退出。打开 CMD先进到解压目录再执行这两条:: 检查当前 Java 版本 java -version :: 再看 JAVA_HOME 指向哪 echo %JAVA_HOME%如果java -version显示的版本不是 17或者JAVA_HOME指到了某个旧 JDK先临时指定 JDK 17 路径再启动set JAVA_HOMEC:\Program Files\Java\jdk-17 set PATH%JAVA_HOME%\bin;%PATH%注意JAVA_HOME要指到 JDK 根目录不是带\bin的目录。上面这个只对当前 CMD 窗口生效长期用的话去系统环境变量里加否则新开一个 shell 又翻车。2.4 第一条启动命令用 console 把日志看清楚解压完毕、JDK 17 确认好后先不要双击 bat而是打开 CMD 执行cd /d C:\neo4j bin\neo4j.bat consoleconsole是前台运行日志直接打在屏幕按 CtrlC 能停。第一次启动会创建data/dbms下的系统库可能要等几秒看到Started.才算真正启动完成不要看到 7474 字样就关窗口。不少 neo4j 菜鸟教程会让你直接start但后台服务的日志写进 logs 目录看不到启动过程报错全靠猜。开发阶段我坚持用 console因为它会暴露路径不对、JDK 版本不对、配置没读进去这类黑匣子问题。确认能稳定启动后再考虑用bin\neo4j.bat install-service装成 Windows 服务。3. 改 neo4j.conf 让 7474 能被外面访问内存参数和监听地址一起改3.1 三个必调参数listen_address、heap 和 pagecacheNeo4j 5.23 的配置用的是server.*前缀别再照抄老博客里的dbms.connector.http.address。我第一次照旧配置改结果 Neo4j 根本不认。现在我会直接打开C:\neo4j\conf\neo4j.conf改这几个参数# 允许所有网卡监听否则只能 127.0.0.1 访问 server.default_listen_address0.0.0.0 server.http.listen_address:7474 server.bolt.listen_address:7687 # 堆内存初始 512m最大 4g dbms.memory.heap.initial_size512m dbms.memory.heap.max_size4g # 页缓存一般给物理内存的四分之一到三分之一 dbms.memory.pagecache.size1g # LOAD CSV 允许读取文件路径 dbms.security.allow_csv_import_from_file_urlstrueserver.default_listen_address0.0.0.0是解决“neo4j 不能通过 ip 访问”的核心。如果这行不写就算端口开了Neo4j 也只监听回环地址。server.http.listen_address:7474里冒号开头表示“端口由 default_listen_address 控制”如果你写成了具体的192.168.1.10:7474那就只监听那一个 IP。内存参数也是重点。8G 内存的机器给 4G heap 加 1G pagecache 基本安全2G 小机器就老老实实把 heap 降到256m/1gpagecache 降到256m否则一导入数据就被系统杀掉。我之前见过有人抱怨“neo4j 没有使用配置文件内存”结果就是配置改完后服务没重启Neo4j 还跑着旧参数。3.2 改完配置怎么验证netstat 比浏览器诚实改完 conf 后的第一件事不是刷新浏览器而是看端口监听状态:: 看 7474 被哪个地址监听 netstat -ano | findstr :7474如果输出是0.0.0.0:7474说明配置读进去了如果还是127.0.0.1:7474说明要么改错文件要么 Neo4j 没重启。console启动时读的是C:\neo4j\conf\neo4j.conf不要改了 Desktop 项目目录里的另一份配置。如果你用的是后台服务方式改完配置必须重启bin\neo4j.bat stop bin\neo4j.bat start只关掉浏览器窗口不算重启neo4j.bat 服务进程还占着旧配置。我见过有人改了配置后一直刷新浏览器当然看不到变化最后发现服务从没停过。3.3 局域网 IP 还是连不上先想防火墙和安全组本机访问localhost:7474正常换成http://192.168.x.x:7474在另一台电脑上超时大概率不是数据库坏了而是防火墙拦了。用管理员身份打开 PowerShell放行 7474 和 7687New-NetFirewallRule -DisplayName Neo4j HTTP 7474 -Direction Inbound -LocalPort 7474 -Protocol TCP -Action Allow New-NetFirewallRule -DisplayName Neo4j Bolt 7687 -Direction Inbound -LocalPort 7687 -Protocol TCP -Action Allow如果机器在云服务器上云平台安全组还要放行这两个端口。这一步和 Windows 防火墙是两套东西漏掉照样连不上。从另一台电脑上先telnet 192.168.x.x 7474测试端口通不通再打开浏览器排查效率会高很多。3.4 首次登录先把默认密码改掉默认账号是neo4j默认密码是neo4j。第一次打开 http://localhost:7474 会要求改密码也可以直接在 bin 目录下用 cypher-shell 改bin\cypher-shell.bat -u neo4j -p neo4j ALTER CURRENT USER SET PASSWORD FROM neo4j TO your-new-password;拿到新密码后再去浏览器登录。千万别一上来就建用户做权限模型社区版单机单库默认用户先跑通业务更重要。4. 给社区版灌第一份数据用 LOAD CSV 跑通知识图谱最小闭环4.1 数据文件放哪file:/// 是 URL不是 Windows 路径zip 方式装的社区版自带import目录。先把 CSV 复制到C:\neo4j\import然后在浏览器执行LOAD CSV WITH HEADERS FROM file:///C:/neo4j/import/people.csv AS row RETURN row LIMIT 5;file:///三个斜杠前两个是协议分隔后面是绝对路径开头。Windows 上必须写正斜杠C:/neo4j/import/people.csv不能写C:\neo4j。用反斜杠时 Neo4j 会把路径字符当成 URL 转义报错相当难看。数据文件第一行必须是表头WITH HEADERS会把row.id、row.name映射成字段。如果文件里有中文尽量把 CSV 存成 UTF-8 无 BOM 编码。Windows 的 Excel 默认保存 ANSI中文导入后全是乱码这比报错还难受。4.2 用 MERGE 同时建节点和关系重复导入不翻车导入前先给 Person 的 id 建约束这样 MERGE 才有资格做“存在就跳过不存在就创建”CREATE CONSTRAINT person_id IF NOT EXISTS FOR (p:Person) REQUIRE p.id IS UNIQUE;然后导入节点LOAD CSV WITH HEADERS FROM file:///C:/neo4j/import/people.csv AS row MERGE (p:Person {id: toInteger(row.id)}) SET p.name trim(row.name), p.age toInteger(row.age);MERGE比CREATE安全同样的导入脚本跑第二遍不会产生重复节点前提是 CSV 里每个人有一个稳定 id。toInteger是显式类型转换不然年龄会变成字符串trim清掉 Excel 里常见的空格。有了节点再导关系。relations.csv 的表头是from_id,to_id,sinceLOAD CSV WITH HEADERS FROM file:///C:/neo4j/import/relations.csv AS row MATCH (from:Person {id: toInteger(row.from_id)}) MATCH (to:Person {id: toInteger(row.to_id)}) MERGE (from)-[r:KNOWS]-(to) SET r.since row.since;这里必须先用 MATCH 找到端点再 MERGE 关系。如果 relations.csv 里有某个 from_id 在 people.csv 里不存在这一行会被默认跳过因为 MATCH 找不到节点。这不是 bug是 Cypher 语义。所以导入前最好先把 relations.csv 里的 id 和 people.csv 做一次反查把不存在的 id 清掉再导。提示如果是几百万行以上的大 CSV别在浏览器里硬跑。先用neo4j-admin database import做全量导入再在业务上做增量。小文件用 LOAD CSV 是性价比最高的方案。4.3 导入完怎么对账三条 count 语句代替肉眼检查导入完不要看图形界面里有没有红红绿绿的节点先用查询对账MATCH (p:Person) RETURN count(p) AS persons; MATCH (:Person)-[r:KNOWS]-(:Person) RETURN count(r) AS relations; MATCH (p:Person) RETURN p.name, p.age ORDER BY p.age DESC LIMIT 10;第一句看节点总数第二句看关系总数第三句抽查字段有没有异常。节点数对但关系数少问题一定在 relations.csv 的引用完整性上。用脚本把不存在的人找出来比在浏览器里一个一个点着查快得多。这一步做完一个“人员-关系”的最小知识图谱就闭环了。后续可以在这个结构上扩展机构、事件、地址做法都是一样要么合并节点要么加关系类型。5. neo4j-chs-community 避坑记录装完 24 小时内最容易翻车的 4 个点5.1 console 闪退窗口一闪而过先查 Java再查启动方式现象双击bin\neo4j.bat console黑色窗口出现一秒就消失日志什么都看不到。原因neo4j.bat 依赖JAVA_HOME。常见三种装的是 JRE 不是 JDKJAVA_HOME写到了jdk-17\bin系统里同时装了多个 JDKCMD 里java指向旧版本。解决不要双击 bat开 CMD先执行java -version、echo %JAVA_HOME%、where java。如果JAVA_HOME末尾带\bin去掉如果多个 JDK把 JDK 17 的路径放到 PATH 最前。用 console 前台启动真正失败时会打出 Java 堆栈照着抄比瞎猜强。5.2 内存配置像没改start 和 console 读的不是同一份配置现象明明在 conf 里把 pagecache 调成了 2gWindows 任务管理器里 Java 进程还是只占几百 MB一导入数据就 OOM。原因要么改错配置文件要么服务没重启。5.23 里server.*和dbms.*混着用抄老教程很容易把旧参数写到失效位置Neo4j 不报错但也不起作用。解决先bin\neo4j.bat stop再用netstat -ano | findstr 7474确认没有残留进程最后用 console 前台启动观察日志有没有把配置文件路径打出来。确认内存是否生效直接在导入大 CSV 时看任务管理器里 java 进程的峰值而不是盯着 idle 状态。5.3 LOAD CSV 一直报文件不存在路径斜杠、import 目录和 allow_csv现象执行 LOAD CSV 返回Could not load CSV或Failed to access file但文件明明就在 C 盘。原因三种最常中招。路径用了反斜杠文件没放到C:\neo4j\import下且没开allow_csv_import_from_file_urls文件名不是纯英文或带空格URL 编码不对。解决统一用file:///C:/neo4j/import/xxx.csv检查 conf 里dbms.security.allow_csv_import_from_file_urlstrue文件名改成纯英文。浏览器里先跑一条RETURN row LIMIT 1的探针查询把错误提前到一行数据避免导入到一半才发现路径错。5.4 局域网 IP 还是访问不了 7474监听地址、防火墙、安全组三层都要通现象本机 localhost 正常换成http://192.168.x.x:7474在另一台电脑上就超时。原因Neo4j 默认只监听 127.0.0.1。只改server.http.listen_address但没改server.default_listen_address端口照样只在回环上或者防火墙没放行或者云主机安全组没开端口。三者缺一个都不通。解决配置里确认server.default_listen_address0.0.0.0重启后用netstat -ano | findstr 7474看输出是0.0.0.0:7474再放行 Windows 防火墙 7474/7687云服务器还要在安全组里加入站规则。从另一台机器telnet 192.168.x.x 7474测端口通了再怪 Neo4j。6. 进阶用 PROFILE 验证路径查询再用 dump 给数据留后悔药6.1 从一个节点出发查多条路径先 EXPLAIN 看索引再 PROFILE 看成本很多人会问“neo4j 查询从一个节点出发如何查询多条”。最直接的做法是限制跳数做一次变长路径查询EXPLAIN MATCH (a:Person {id: 1})-[*1..3]-(m) RETURN m.name, count(*) AS paths ORDER BY paths DESC;EXPLAIN不会真正执行只给执行计划。如果计划里出现NodeByLabelScan而不是NodeIndexSeek说明 Person.id 没有索引。先建索引CREATE INDEX person_id IF NOT EXISTS FOR (p:Person) ON (p.id);约束自带索引上面如果已经建过约束就不用重复建。确认索引命中后再用 PROFILE 看真实成本PROFILE MATCH (a:Person {id: 1})-[*1..3]-(m) RETURN m.name, count(*) AS paths ORDER BY paths DESC LIMIT 20;PROFILE 会真实执行一次观察输出里的db hits和rows。如果 rows 暴涨说明中段结果太多把 3 改成 2或者给关系加上方向-[r:KNOWS]-查询速度经常能翻几倍。这个习惯比背语法有用得多。6.2 升级或改动前先 dump比复制 data 目录更可靠改配置、升级版本、导入大批量数据之前先 dump 一次。不要直接复制data/dbms目录Windows 下 Java 进程会占着 store lock拷出来的文件可能是裂开的。:: 停服务后再 dump bin\neo4j.bat stop :: 备份默认 neo4j 数据库到 D 盘 bin\neo4j-admin.bat database dump neo4j --to-pathD:\neo4j_backup恢复时也要先停服务再把 dump 文件 load 回去bin\neo4j-admin.bat database load neo4j --from-pathD:\neo4j_backup恢复前如果原库还存在load 会报库已存在先确认没有业务在读写必要时在副本库上做验证。我自己现在的习惯是每次动 conf 或升级版本前先 dump 一份再在副本上重建索引、跑一遍 EXPLAIN确认计划里没有全表扫描才回生产执行。这个顺序帮我躲过好几次导入后路径查询爆炸的现场。希望帮到你。本文还有配套的精品资源点击获取