使用Shadowrocket的include配置包含功能，核心逻辑是创建独立的子配置文件，再通过主配置文件中的include = 文件路径语句将其内容合并加载。用户先使用文本编辑器创建包含规则、策略组或DNS设置的独立.conf文件，保存至Shadowrocket可访问的目录（如iCloud Drive中的Shadowrocket文件夹）。随后在主配置的目标段落（通常是[Rule]或[Proxy Group]）中插入include语句，指定文件的相对或绝对路径，保存并重新加载主配置即可生效。该功能适合将广告屏蔽规则、策略组定义或分流规则等模块独立维护，实现配置的复用和分治管理，避免单一配置文件的臃肿和重复劳动。需注意文件路径的准确性、引用顺序对优先级的影响，以及避免循环引用导致加载失败。include仅支持本地文件，远程内容请通过订阅功能获取。建议用户从少量文件开始尝试，逐步建立适合自己管理习惯的模块化配置结构，并定期检查被引用文件的内容有效性，确保配置加载始终完整无误。
include功能的核心定位与设计初衷
模块化配置管理的核心价值
include是Shadowrocket配置文件中用于引用外部配置文件内容的参数，它的核心价值是实现配置的模块化管理。用户可将庞大的配置文件拆分成多个逻辑单元——例如将规则列表单独保存、将策略组独立存放、将DNS设置分离出来，再通过include指令在主配置文件中集中引用。这种模块化设计显著提升了配置的可维护性和可读性，尤其适合规则数量庞大的高级用户场景。
避免重复劳动与配置复用
通过include功能，用户可创建一份通用的规则库文件，然后在多个不同的主配置文件中引用它，实现一次编写、多处复用。例如维护一个包含常见广告屏蔽域名的列表，将其作为独立的include文件后，无论是日常使用的配置文件还是专门用于流媒体的配置文件，均可通过一行include语句共享这份规则，避免了重复复制粘贴带来的维护负担和版本不一致问题。
与远程订阅更新的协同工作
对于使用订阅链接获取节点的用户，include功能允许在不修改订阅源文件的前提下，在本地添加额外的自定义规则或参数。用户可在本地配置文件中通过include引入订阅内容，再叠加自定义规则，这样当订阅更新时，自定义内容不会被覆盖，两者相互补充而非冲突。这解决了订阅配置与本地需求之间的兼容性痛点。
include的基本语法与文件格式
配置语句的正确书写方式
在Shadowrocket配置文件的[General]段落或[Rule]段落中，使用include = /path/to/file.conf格式引用外部文件。路径支持相对路径和绝对路径：相对路径基于配置文件所在目录，绝对路径则需以/开头指定完整位置。示例写法为include = ./custom-rules.conf表示引用同一目录下的custom-rules.conf文件，include = /var/mobile/Configs/adblock.conf则引用指定绝对路径的文件。
被引用文件的格式要求与限制
被include引用的文件必须遵循与Shadowrocket主配置文件相同的格式规范，即同样采用段落标题（如[Rule]、[Host]）和键值对结构。文件内容可以是完整的配置段落，也可以是仅包含规则列表的片段。需注意被引用文件中不能包含重复的段落标题，否则解析可能出错。最安全的做法是让每个include文件仅包含一个段落的内容。
多文件引用的顺序与加载逻辑
用户可在同一主配置文件中多次使用include语句，引用多个不同的外部文件。文件内容被插入到include语句所在位置，并按书写顺序依次加载。若不同文件中定义了相同的规则或参数，后者将覆盖前者。理解这一加载顺序有助于合理安排文件引用次序，确保自定义规则能够覆盖订阅或通用规则中的冲突项。
include功能的实际应用场景
将广告屏蔽规则独立维护
创建一个专门的adblock-rules.conf文件，其中包含所有广告域名和IP段的屏蔽规则。在主配置文件的[Rule]段落中使用include = ./adblock-rules.conf引用该文件。当需更新广告规则时，仅需修改这一个文件，所有引用了该文件的主配置自动获得最新的规则列表，无需逐份修改。这对于同时维护多份配置文件（如工作场景、家庭场景、移动场景）的用户极为便利。
策略组与分流规则的分离管理
将策略组定义（[Proxy Group]）和分流规则（[Rule]）分别存放在不同的include文件中。例如policy-groups.conf专门存放策略组配置，rules-daily.conf存放日常浏览规则，rules-streaming.conf存放流媒体专用规则。用户可通过更换引用的规则文件快速切换使用场景，无需每次重新编写或注释大量规则行，配置切换效率大幅提升。
节点订阅与本地自定义内容的整合
若用户使用订阅链接获取节点列表，可在主配置中使用[General]段落包含订阅URL，然后在该段落之后通过include引入本地规则文件。这样订阅更新时节点信息自动刷新，而本地规则完全不受影响，持续生效。用户还可通过此方式为订阅节点补充本地策略组配置，实现远程节点与本地策略的混合管理。
创建与编辑include文件的操作步骤
使用文本编辑器创建独立配置文件
在iOS设备上，用户可通过Shadowrocket内置的配置编辑器创建新文件，或使用系统“文件”应用新建文本文件。推荐使用支持语法高亮的文本编辑器（如Textastic或Runestone）编辑.conf后缀的文件，以降低语法错误的概率。创建的文件需保存在Shadowrocket可访问的目录中，通常为iCloud Drive下的Shadowrocket文件夹或设备本地存储中的应用共享目录。
在主配置文件中正确引用外部文件
打开Shadowrocket的主配置文件，定位至希望插入外部内容的段落位置，输入include = 文件路径。确保路径指向之前创建的文件，且路径中的目录层级与实际存放位置一致。保存主配置文件后，Shadowrocket会在加载时自动读取并合并include文件中的内容。若引用多个文件，每个include语句独占一行，按从上到下的顺序依次加载。
利用Shadowrocket界面导入外部文件
在Shadowrocket的配置管理界面，点击右上角的“+”按钮，选择“从文件导入”或“从URL导入”来添加外部配置文件。导入的文件会自动保存至应用的配置列表，用户可在主配置的编辑界面中通过文件浏览器选择已导入的文件路径。界面操作降低了手动输入路径的风险，尤其适合不熟悉文件系统结构的用户使用。
include使用的限制与注意事项
文件路径错误的常见表现与处理
若include指定的文件路径不存在或Shadowrocket无权限访问，应用在加载配置时会忽略该include语句并继续加载后续内容，同时可能在日志中输出警告信息。用户无法在界面中直接看到错误提示，需通过开启详细日志或观察配置功能是否完整来判断文件是否被正确加载。排查时应先确认文件确实存在于指定路径，且文件名和扩展名完全匹配。
循环引用的检测与避免
主配置文件中若通过include引用了文件A，而文件A中又通过include引用了主配置文件本身，即形成循环引用。Shadowrocket在加载时会对循环引用进行检测并中断加载，导致配置完全失效。用户应保持引用链的单向性，避免跨文件相互引用。建议设计清晰的引用层级：主配置文件为顶层，include文件为底层，底层文件不再引用其他文件或仅引用更底层的文件。
订阅更新与include文件的优先级
当使用远程订阅链接时，订阅服务器可能也提供了自己的规则配置。若主配置中通过include引入了本地文件，且本地文件与订阅内容存在冲突（如同名策略组的不同定义），加载顺序决定了最终生效的内容。通常订阅内容先加载，本地include文件后加载，因此本地规则会覆盖订阅中的同名项。用户需根据此优先级设计配置，确保自定义内容能够生效。
与其他配置管理方式的对比
include与多配置文件切换的差异
多配置文件切换需要用户在多个完整配置之间切换，每次切换加载整个配置的全部内容。而include允许用户共享通用模块，主配置仅保存差异化内容，减少了重复数据量。对于仅有少量规则差异的场景（如不同节点集合），使用include共享规则库比维护多个完整配置更加高效，变更通用规则时也只需修改一次。
include与分流规则分组的关系
Shadowrocket的规则分组（通过策略组实现）是在规则引擎内部对不同类型的流量进行分类，而include是在配置加载阶段对配置文件本身进行模块化组织。两者处于不同层级：include解决的是“如何管理配置文本”的问题，策略组解决的是“如何分流流量”的问题。用户可同时使用两者，通过include组织规则文件，再通过策略组实现规则内部的分组调度。
include与URL Scheme远程配置的关系
URL Scheme允许用户通过链接一键切换配置文件或执行特定操作，适用于自动化场景。include则是静态的配置组织方式，在配置加载时完成文件合并。两者可协同工作：用户可使用URL Scheme快速切换引用不同include文件的主配置，实现场景化的动态配置管理，满足复杂且多变的网络环境需求。
常见问题FAQ
include引用文件后规则不生效是什么原因
常见原因包括：文件路径错误导致未成功加载、被引用文件中的格式语法有误（如缺少段落标题或括号不匹配）、引用顺序导致规则被后续内容覆盖。用户应先检查文件路径是否正确，然后验证被引用文件的格式是否符合Shadowrocket规范，最后确认include语句在主配置文件中的位置是否符合预期加载顺序。
被include的文件能否包含节点信息
可以，但需注意节点信息若包含在include文件中，该文件就成了节点配置的一部分。若多个主配置引用同一节点文件，切换配置时节点信息保持一致。通常建议将节点信息放在主配置或独立的节点文件中管理，规则部分单独放另一文件，以实现节点与规则的解耦，提高灵活性。
include是否支持远程URL引用
Shadowrocket的include参数目前仅支持本地文件路径，不支持直接引用远程URL。若需引用远程内容，可使用订阅功能将远程URL添加至[General]段落的proxy-provider或直接使用订阅链接。远程规则获取请通过订阅机制实现，include专为本地文件管理设计，两者分工明确不可混用。