快速入门:使用 GitHub Copilot 现代化功能升级 JavaScript 或 TypeScript 项目中的 npm 包

本快速入门将向你介绍如何使用 GitHub Copilot 的现代化功能来升级 JavaScript 或 TypeScript 项目中的 npm 包。 GitHub Copilot 面向 JavaScript/TypeScript 的现代化功能会分析您的项目、建议升级计划、自动升级软件包,并帮助您应用任何必要的代码更改。

先决条件

打开项目

在Visual Studio Code或Visual Studio中打开 JavaScript 或 TypeScript 项目。 项目必须包含一个 package.json 文件,该工具才能检测它。

开始升级

若要启动 npm 包升级过程,请遵循 IDE 指南:

通过以下方式之一启动升级会话:

  • 从窗口左侧的活动栏中打开GitHub Copilot 现代化视图。 在视图中,选择“ 升级 npm 包 ”按钮。 仅当工具检测到 package.json 项目中的文件时,才会显示此按钮。 然后,Copilot 对话助手窗口会自动打开。
  • 打开Copilot 对话助手,选择代理模式,然后输入描述要执行的操作的提示,例如“升级 TypeScript 项目中的 npm 包”。

启动会话后,Copilot分析项目并提出升级计划。 继续执行以下步骤:

  1. 在Copilot 对话助手窗口中查看计划。

  2. 按照Copilot 对话助手中的提示操作。 Copilot 会在引导你完成升级各个阶段的过程中提出问题并请求你确认。 该工具是交互式的,因此当聊天窗口中出现问题时,请及时回答。

  3. Copilot升级 package.json 文件,为项目运行相应的包管理器命令(如 npm installnpm updatepnpm installyarn install),并建议更改代码(如果有重大更改或 API 更新需要修改)。

在后台,该工具在迭代循环中运行:它分析项目、进行更改、验证生成或检查问题,并在必要时重复。 此过程在Copilot的代理模式下运行,以提供智能的上下文感知帮助。 该工具为升级会话创建专用分支,并在其工作时自动向该分支提交更改。

Tip

除了 npm 包升级之外,GitHub Copilot JavaScript/TypeScript 的现代化可以帮助通过Copilot 对话助手中的自然语言提示完成相关的现代化任务。 例如,可以要求它升级项目中的 TypeScript 编译器版本。

查看更改并创建拉取请求

升级会话完成后,请查看该工具执行的操作,并确定是否合并工作:

  1. 打开 summary.md 下的 <project>/.github/modernize/code-migration/<timestamp>/,查看升级会话所做更改的概览。

  2. 使用 IDE 的源代码管理工具查看该工具在升级分支上所做的提交记录。

  3. 运行项目的生成和测试脚本,验证升级后的项目是否按预期方式运行。

  4. 当你对这些更改感到满意后,请按照你偏好的 Git 工作流程,从升级分支向主分支发起拉取请求。

后续步骤