本地开发优先推荐两种方案：
- Docker 一键启动（推荐，环境统一、不污染本机、切换版本方便）
- Neo4j Desktop 可视化客户端（新手友好，多库管理）
方案1 Docker
1、前置准备
安装 Docker Desktop（官网下载），启动 Docker。
2、一键启动命令（自定义端口、内置 APOC）
打开终端（PowerShell / CMD / 终端）执行：
bash
运行
docker run -d \ --name neo4j-dev \ --restart no \ -p 7474:7474 \ -p 7687:7687 \ -v D:/neo4j_dev_data:/data \ # Windows持久化目录 # -v ~/neo4j_dev_data:/data \ # macOS替换此行 -e NEO4J_AUTH=neo4j/dev@123456 \ -e NEO4J_PLUGINS='["apoc"]' \ -e NEO4J_dbms_memory_heap_max_size=2G \ neo4j:5.20参数说明：
- 账号：
neo4j密码：dev@123456，本地开发简单密码 - 自动安装 APOC 插件，做文本实体抽取必备
- 数据挂载本地文件夹，删除容器数据不丢失
- heap 内存 2G，满足本地金相图谱调试
修改默认端口
启动命令直接映射（推荐，不用改容器内部配置）
只改宿主机对外端口，容器内部仍使用 7474/7687，无需修改 conf
bash
运行
docker run -d \ --name neo4j-graphrag \ -p 8080:7474 \ # 宿主机8080 → 容器7474网页 -p 8081:7687 \ # 宿主机8081 → 容器7687程序连接 -e NEO4J_AUTH=neo4j/Neo4j@2026 \ neo4j:5.20Python 连接：bolt://IP:8081，浏览器：http://IP:8080
4、本地访问
网页管理面板：http://127.0.0.1:7474Python 连接地址：bolt://127.0.0.1:7687
5、Python 本地连接配置（settings.py）
python
运行
NEO4J_URI = "bolt://127.0.0.1:7687" NEO4J_USER = "neo4j" NEO4J_PASSWORD = "dev@123456"日常开发常用命令
bash
运行
# 查看实时日志，调试报错 docker logs -f neo4j-dev # 停止 docker stop neo4j-dev # 重启 docker restart neo4j-dev # 删除容器（数据还在本地挂载目录） docker rm neo4j-dev方案2 Desktop可视化
1、下载安装
官网：https://neo4j.com/download/neo4j-desktop/ Windows/macOS 直接安装图形化软件。
2、创建本地开发数据库
- 打开软件 → 点击Create DBMS
- Name：
metallurgy_dev - Password：
dev@123456 - Version 选择 5.20，创建
- 点击 Start 启动数据库
3、安装 APOC 插件（必须）
- 数据库卡片右侧
Plugins - 搜索
APOC点击安装 - 重启数据库生效
4、本地连接信息
- Web 地址：
http://localhost:7474 - Bolt：
bolt://localhost:7687
优势
- 图形界面管理多个数据库（开发 / 测试分开）
- 内置查询编辑器、图谱可视化、数据导入导出
- 一键启停，无需命令行