You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何在GitHub Copilot中配置固定base prompt与上下文?

如何为GitHub Copilot设置项目专属的固定上下文与编码规范约束

一、定义项目级固定上下文(模拟Base Prompt)

GitHub Copilot暂无直接设置全局Base Prompt的官方选项,但可以通过以下方式让Copilot自动读取项目专属上下文:

  • 在项目根目录创建专属提示文件,比如命名为.copilot-guidelines.md,将项目的业务需求、技术栈偏好、通用规则等写入其中,Copilot会自动扫描项目内的文档文件并参考内容生成代码。示例内容:

项目技术栈:React + TypeScript + Redux Toolkit
编码核心规则:变量用小驼峰,类/组件用大驼峰,禁止使用var;所有接口请求必须封装在src/services目录,统一使用Axios拦截器;组件必须添加Props类型定义,优先使用函数组件。
业务重点:用户中心模块需保证数据加密传输,操作日志需同步写入后端。

  • 在单个文件头部添加固定注释块,作为当前文件的专属上下文提示,Copilot会优先参考当前文件的头部注释生成代码。示例:
// 模块职责:处理购物车的增删改查逻辑
// 编码规范:函数必须添加JSDoc注释,参数和返回值需标注类型;状态更新使用Immer不可变写法

二、确保Copilot遵循编码规范与命名规则

  • 依托项目的ESLint/Prettier配置文件:Copilot会自动识别项目中的.eslintrc.js、.prettierrc等配置文件,按照其中定义的规则生成代码。比如ESLint开启camelcase规则后,Copilot生成的变量会自动采用小驼峰命名。
  • 提供示例代码引导:在文件中先编写1-2个符合规范的变量、函数或类,Copilot会延续当前的风格生成后续代码。
  • 在项目package.json的description或专门的scripts注释中补充规范细节,Copilot同样会读取这些内容作为参考依据。

三、让固定上下文持久生效

  • 项目级规则持久化:将.copilot-guidelines.md这类提示文件放在项目根目录,提交到Git仓库中,Copilot在整个项目会话中都会持续参考该文件内容。
  • 单个文件规则持久化:通过VS Code的自定义代码片段功能,创建包含规范注释的文件模板,新建文件时直接插入模板内容,确保每个新文件都自带上下文提示。示例代码片段配置:
{
  "Project Component Template": {
    "prefix": "proj-comp",
    "body": [
      "// 组件类型:$1",
      "// 编码规范:Props使用TypeScript接口定义,样式使用CSS Modules,禁止内联样式",
      "import React from 'react';",
      "",
      "interface $1Props {",
      "  $2",
      "}",
      "",
      "const $1: React.FC<$1Props> = ({ $2 }) => {",
      "  return <div>$0</div>;",
      "};",
      "",
      "export default $1;"
    ],
    "description": "Template for project-specific React components with Copilot guidelines"
  }
}

内容的提问来源于stack exchange,提问作者Saud Iqbal

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.16 06:36:11