Neo4j 不是文件数据库，它不支持直接读写本地文件来操作图数据——你不能像打开
graph.db文件夹那样用
File.ReadAllBytes或
FileStream去“操作”它。所有交互必须走官方驱动的网络协议。
Neo4j 是服务端数据库，不是嵌入式文件库
很多人误以为
neo4j-community-5.x解压后那个
data/databases/graph.db目录可以直接被 C# 程序读写。实际上：这个目录是 Neo4j 进程私有管理的存储格式（底层是记录页+日志+映射表），没有公开、稳定、跨版本的文件结构文档；直接修改会破坏一致性，导致启动失败或数据损坏；C# 里用
Directory.Delete或
File.Copy操作该目录 ≠ 备份/迁移，只是复制了一堆不可用的二进制碎片。
正确路径只有一条：通过 Bolt 协议连接运行中的 Neo4j 实例。
确保 Neo4j 服务已启动（neo4j start或 Windows 服务运行中） 确认
dbms.connector.bolt.enabled=true和
dbms.default_listen_address=0.0.0.0在
conf/neo4j.conf中已配置 防火墙放行 7687 端口（Bolt 默认端口）
用 Neo4j.Driver 连接并执行 Cypher
官方
Neo4j.DriverNuGet 包（v5+）是唯一推荐方式。它封装了连接池、自动重连、事务生命周期，比手写 HTTP 请求或反序列化文件安全得多。
安装包：
NuGet Install-Package Neo4j.Driver
基础用法示例：
var driver = GraphDatabase.Driver("bolt://localhost:7687", AuthTokens.Basic("neo4j", "password"));
using var session = driver.AsyncSession();
var result = await session.ExecuteReadAsync(async tx =>
{
var cursor = await tx.RunAsync("MATCH (n:Person) WHERE n.age > $age RETURN n.name", new { age = 30 });
return await cursor.ToListAsync();
});
不要在每次查询都新建 GraphDatabase.Driver——它很重，应全局单例或依赖注入生命周期管理 避免用
session.ReadTransaction后再手动
CommitAsync；优先用
ExecuteReadAsync/
ExecuteWriteAsync，它们自动处理事务边界 参数必须用命名占位符（
$age），不能字符串拼接，否则引发 Cypher 注入
本地开发时如何“假装”文件操作？
如果你真需要类似“加载本地图文件”的体验（比如测试用小数据集），可行做法是：把 Cypher 脚本存成
.cypher文本文件，再用驱动批量执行。
例如
init-graph.cypher：
CREATE (:Person {name: 'Alice', age: 32});
CREATE (:Person {name: 'Bob', age: 28});
CREATE (a:Person {name: 'Alice'})-[:FRIEND]->(:Person {name: 'Charlie'});
然后在 C# 中读取并执行：
var script = File.ReadAllText("init-graph.cypher");
await session.ExecuteWriteAsync(tx => tx.RunAsync(script));
注意：大脚本要分批（每 100–500 行一个 RunAsync），否则可能触发 Neo4j 的语句超时或内存限制 不要用
CREATE反复执行同一脚本——加
MERGE或先
MATCH判断存在性，否则报重复键错误
.cypher文件只是文本，不是数据库快照；它不包含索引、约束、用户权限等元信息
真正需要离线图分析的场景，别硬套 Neo4j：考虑
GraphSharp、
QuickGraph这类纯内存图库，或者导出为 GraphML/CSV 再加载。Neo4j 的“文件”从来就不是接口，而是实现细节——碰它，等于绕过引擎直接拧活塞。
