GitHub Copilot 频繁忽略项目特有架构约束，需通过五步法注入项目级上下文：一、配置全局宪法文件；二、按路径注入分层指令；三、显式引用跨域关联文件；四、构建模块关系图谱注释；五、固化领域语义词典。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 GitHub Copilot 时发现它频繁忽略项目特有的模块划分、跨服务调用关系或领域模型约束，则很可能是项目级上下文未被有效注入。以下是引导 AI 理解复杂工程结构的具体操作路径：
一、配置全局项目宪法文件
该方法通过在仓库根目录部署指令文件，向 Copilot 注入长期稳定的技术栈与架构约束，使其在任意位置生成代码时均遵循统一规范。此文件构成 Copilot 的“最高指令层”，权重高于临时选区或单文件内容。
1、在项目根目录创建 .github/copilot-instructions.md 文件。
2、写入结构化声明，明确项目分层逻辑与边界规则，例如：
- 后端采用六边形架构，application/ 目录仅包含用例类，domain/ 目录禁止引用 infrastructure/ 中的实现类；
- 所有 API 响应必须封装为 ApiResponse<T> 泛型结构，禁止裸露原始 DTO；
- 禁止在 web/ 层直接调用数据库 Repository。
3、保存后重启 VS Code 或刷新 Copilot 状态，确保文件被索引识别。
二、按路径注入分层指令文件
当不同模块存在异构技术选型或设计契约时，需将全局规则细化到子路径，避免单一宪法文件过度膨胀或产生冲突。路径级指令可覆盖全局规则中特定条款，形成上下文优先级链。
1、在 .github/instructions/ 目录下新建路径匹配文件，如 backend-application.instructions.md。
2、在文件头部添加 applyTo: "src/main/java/com/example/backend/application/**" 声明。
3、定义该路径专属约束，例如：
- 所有用例类必须继承 UseCase<I, O> 抽象基类；
- 方法命名强制使用 execute() 入口，禁止添加业务动词前缀；
- 输入参数必须为不可变值对象，禁止使用 Map 或 JSONObject。
三、显式引用跨域关联文件
Copilot 默认仅感知当前编辑文件及相邻打开 Tab，对于涉及多模块协作的逻辑（如 Controller 调用远端 Domain Service），必须主动提供调用链上下游代码片段，否则 AI 将基于通用模式虚构接口。
1、在 Copilot Chat 输入框中，使用 @ 符号显式标注关键依赖文件路径，例如：
@src/main/java/com/example/domain/order/OrderService.java
@src/main/java/com/example/infrastructure/payment/PaymentGateway.java。
2、紧随引用后输入任务描述，例如：“分析上述两个文件，生成一个协调订单创建与支付发起的 ApplicationService 实现。”
3、若文件过长，先在编辑器中选中核心接口定义段落再触发 Copilot，避免注入无关实现细节。
四、构建模块关系图谱注释
对于高度解耦的微服务或领域驱动设计项目，仅靠文本指令难以传达模块间职责边界与数据流向。此时需将架构意图编码为可被 Copilot 解析的轻量图谱注释，嵌入入口类或 README。
1、在 src/main/java/com/example/RootApplication.java 类顶部添加多行注释块。
2、使用 ASCII 图形描述核心交互，例如：
// [OrderContext] → (creates) → [PaymentContext]
// ↑ ↓
// └─── [InventoryContext] ← (reserves)。
3、在注释中明确标注各 Context 对应的包路径与主实体，例如：
// OrderContext = com.example.domain.order
// PaymentContext = com.example.infrastructure.payment。
五、固化领域语义词典
当项目使用大量自定义领域术语（如 “履约单”、“核销码”、“账期结算单元”）时，Copilot 易将其误判为通用词汇并替换为近义词。需建立显式术语映射表，强制统一语义解释。
1、在 .github/copilot-instructions.md 底部追加 ## 领域术语表 小节。
2、逐条定义术语及其技术含义，例如：
- “履约单”：指 OrderFulfillmentRecord 实体，存储于 fulfillment_db 数据库，生命周期独立于订单主表；
- “核销码”：指 WriteOffCode 值对象，由 8 位大写字母+数字组合生成，仅用于 offline_payment 场景。。
3、禁止使用模糊表述如“类似订单”“相当于凭证”，全部采用 “指……实体/值对象/服务” 的确定性句式。
