本快速入门将向你介绍如何使用 GitHub Copilot 的现代化功能来升级 JavaScript 或 TypeScript 项目中的 npm 包。 GitHub Copilot 面向 JavaScript/TypeScript 的现代化功能会分析您的项目、建议升级计划、自动升级软件包,并帮助您应用任何必要的代码更改。
先决条件
- Node.js 和 npm。
- GitHub Copilot。 在 IDE 中登录到GitHub帐户。
- 以下开发环境之一:
- Visual Studio Code 配合 GitHub Copilot 现代化扩展程序。
- Visual Studio 2026 版本 18.8.1 或更高版本(包含适用于 JavaScript/TypeScript 的 GitHub Copilot 现代化功能)。
打开项目
在Visual Studio Code或Visual Studio中打开 JavaScript 或 TypeScript 项目。 项目必须包含一个 package.json 文件,该工具才能检测它。
开始升级
若要启动 npm 包升级过程,请遵循 IDE 指南:
通过以下方式之一启动升级会话:
- 从窗口左侧的活动栏中打开GitHub Copilot 现代化视图。 在视图中,选择“ 升级 npm 包 ”按钮。 仅当工具检测到
package.json项目中的文件时,才会显示此按钮。 然后,Copilot 对话助手窗口会自动打开。 - 打开Copilot 对话助手,选择代理模式,然后输入描述要执行的操作的提示,例如“升级 TypeScript 项目中的 npm 包”。
启动会话后,Copilot分析项目并提出升级计划。 继续执行以下步骤:
在Copilot 对话助手窗口中查看计划。
按照Copilot 对话助手中的提示操作。 Copilot 会在引导你完成升级各个阶段的过程中提出问题并请求你确认。 该工具是交互式的,因此当聊天窗口中出现问题时,请及时回答。
Copilot升级
package.json文件,为项目运行相应的包管理器命令(如npm install、npm update、pnpm install或yarn install),并建议更改代码(如果有重大更改或 API 更新需要修改)。
在后台,该工具在迭代循环中运行:它分析项目、进行更改、验证生成或检查问题,并在必要时重复。 此过程在Copilot的代理模式下运行,以提供智能的上下文感知帮助。 该工具为升级会话创建专用分支,并在其工作时自动向该分支提交更改。
Tip
除了 npm 包升级之外,GitHub Copilot JavaScript/TypeScript 的现代化可以帮助通过Copilot 对话助手中的自然语言提示完成相关的现代化任务。 例如,可以要求它升级项目中的 TypeScript 编译器版本。
查看更改并创建拉取请求
升级会话完成后,请查看该工具执行的操作,并确定是否合并工作:
打开
summary.md下的<project>/.github/modernize/code-migration/<timestamp>/,查看升级会话所做更改的概览。使用 IDE 的源代码管理工具查看该工具在升级分支上所做的提交记录。
运行项目的生成和测试脚本,验证升级后的项目是否按预期方式运行。
当你对这些更改感到满意后,请按照你偏好的 Git 工作流程,从升级分支向主分支发起拉取请求。