macOS 平台 Neo4j 图数据库安装与核心操作指南
一、环境准备
- 操作系统：macOS 10.14 及以上
- 运行环境：Java 11+（推荐 Eclipse Temurin 或 OpenJDK）
安装 Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
安装 Java
brew install openjdk@11
二、Neo4j 安装步骤
方式 1：Homebrew 安装（推荐）
brew install neo4j
brew services start neo4j
方式 2：手动安装
- 下载社区版：Neo4j Download Center
- 解压并启动：
tar -xf neo4j-community-5.10.0-unix.tar.gz
cd neo4j-community-5.10.0/bin
./neo4j start
三、验证安装
终端检测
neo4j status
访问 Web 控制台
浏览器打开：http://localhost:7474
- 默认账号：
neo4j - 默认密码：
neo4j（首次登录会提示修改）
四、核心操作指南
1. Cypher 基础语法
// 创建节点
CREATE (:Person {name: 'Alice', age: 30})
CREATE (:Company {name: 'TechCorp'})
// 建立关系
MATCH (a:Person), (b:Company)
WHERE a.name = 'Alice'
CREATE (a)-[:WORKS_AT]->(b)
2. 数据查询
// 查找所有人员
MATCH (p:Person) RETURN p
// 路径查询
MATCH path=(:Person)-[:WORKS_AT]->(:Company)
RETURN path LIMIT 5
3. 数据导入（CSV 示例）
将 CSV 文件放置于 Neo4j 的 import 目录下，然后执行：
LOAD CSV WITH HEADERS FROM 'file:///employees.csv' AS row
CREATE (:Employee {
id: row.id,
name: row.name,
department: row.dept
})
五、进阶技巧
APOC 扩展库
安装并启用 APOC 后，可使用高级图算法：
CALL apoc.path.spanningTree((:Person {name:'Alice'}), {maxLevel:3})
全文搜索
CALL db.index.fulltext.createNodeIndex("peopleSearch", ["Person"], ["name"])
索引优化
CREATE INDEX person_name_index FOR (p:Person) ON (p.name)
六、常见问题解决
| 问题现象 | 解决方案 |
|---|---|
| 端口 7474 被占用 | 修改配置：neo4j config set dbms.connector.http.listen_address=:7475 |
| Java 版本冲突 | 在 neo4j.conf 中指定 JAVA_HOME=/path/to/jdk11 |
| 内存不足 | 修改 conf/neo4j.conf 中的 dbms.memory.heap.max_size 参数 |
七、学习资源推荐
- 官方文档：https://neo4j.com/docs/
- 图算法指南：https://neo4j.com/docs/graph-data-science/current/algorithms/
- 沙盒环境：https://sandbox.neo4j.com/
最佳实践提示：开发环境建议使用 Docker 容器部署，生产环境务必配置认证和 HTTPS 加密。通过
EXPLAIN命令分析查询性能，定期使用apoc.monitor监控数据库状态。
