上下文导入与排障

Memory Import Processor 解析上下文文件里的 @file.md，把相关指令拆成小文件，便于复用和审查。相对路径从包含该导入的文件目录解析，也支持绝对路径。

导入形式

# Main GEMINI.md file

@./components/instructions.md
@../shared/style-guide.md

同目录使用 @./file.md，父目录 @../file.md，绝对路径可写 @/absolute/path/to/file.md。被导入文件也可继续导入，多个导入可以出现在同一行；跨机器共享时通常使用可移植的相对路径。

解析边界

处理器识别循环并阻止递归，默认最大导入深度为 5 层。路径还须位于允许目录，不是知道一个绝对路径就能读取任意文件。代码块及行内代码里的 @ 不作为导入执行，所以可以在手册中展示语法。

缺失文件在输出中留下错误注释，访问权限及文件系统错误也会被报告；不要把一次会话能启动当作所有导入都成功。导入树保留文件顺序和链路，有助于定位错误来源。

调试顺序

先检查相对路径基准、目标是否存在及可读，再看是否超出允许范围、有循环或嵌套过深。避免同一个团队规范被多处重复导入；拆分后查看 /memory show，确认最终上下文内容符合预期。

官方提到可配置最大深度，但本页不编造公开 settings 键名。普通使用者可通过减少嵌套解决大部分深度问题；处理器内部 API 与 CLI 配置入口不能混为一谈。