首页 / 文件路径（File Path）
📖 文件路径（File Path） 是什么？
文件路径像快递地址：从哪个城市哪条路哪栋房，一层层写清楚。
⚡ 一句话秒懂
文件路径像快递地址：从哪个城市哪条路哪栋房，一层层写清楚。
📖 举个故事
你给朋友寄快递，只写"我家"他肯定收不到，得写省、市、小区、门牌号。电脑找文件也一样：/Users/mac/Documents/report.txt 的意思是，从根目录出发，进 mac 的家，再进 Documents 文件夹，找到 report.txt。还有种写法叫相对路径，好比"就在隔壁"——从你当前站的位置出发去找，走错地方就找不到文件了。
💡 类比理解
暂未补充。
🧩 真实例子
暂未补充。
🛠️ 怎么实际使用
AI Agent 读取本地知识库文件时，路径写错是最常见的报错。比如脚本放在项目根目录运行时能找到 data/docs/，但换了运行目录，相对路径就失效报"文件不存在"。稳妥做法是在代码里基于脚本自身位置拼绝对路径，或者启动时把工作目录固定下来。
📚 进阶原理
绝对路径从根目录写起（Linux/macOS 如 /home/user/file，Windows 如 C:\file），相对路径基于当前工作目录（cwd），. 表示当前目录，.. 表示上一级。常见错误：FileNotFoundError 多为 cwd 与预期不符、大小写不匹配或分隔符写反。Python 建议用 pathlib 拼路径，自动处理系统差异。Agent 工具（如读写文件的 function call）收到路径参数时应先做规范化与安全校验，防止越权访问。