你的第一个扩展
在本主题中,我们将教你构建扩展的基本概念。请确保已安装 Node.js 和 Git。
首先,使用 Yeoman 和 VS Code 扩展生成器来搭建一个准备好进行开发的 TypeScript 或 JavaScript 项目。
-
如果你不想安装 Yeoman 以备将来使用,请运行以下命令
npx --package yo --package generator-code -- yo code
-
如果你想全局安装 Yeoman 以便重复运行,请运行以下命令
npm install --global yo generator-code yo code
对于 TypeScript 项目,填写以下字段
# ? What type of extension do you want to create? New Extension (TypeScript)
# ? What's the name of your extension? HelloWorld
### Press <Enter> to choose default for all options below ###
# ? What's the identifier of your extension? helloworld
# ? What's the description of your extension? LEAVE BLANK
# ? Initialize a git repository? Y
# ? Which bundler to use? unbundled
# ? Which package manager to use? npm
# ? Do you want to open the new folder with Visual Studio Code? Open with `code`
在编辑器中,打开 src/extension.ts
并按 F5 或从命令面板(⇧⌘P(Windows、Linux Ctrl+Shift+P))运行命令 Debug: Start Debugging。这将在新的扩展开发宿主窗口中编译并运行扩展。
在新窗口中从命令面板(⇧⌘P(Windows、Linux Ctrl+Shift+P))运行 Hello World 命令
您应该会看到显示 Hello World from HelloWorld!
的通知。成功!
如果你在调试窗口中看不到 Hello World 命令,请检查 package.json
文件,并确保 engines.vscode
版本与已安装的 VS Code 版本兼容。
开发扩展
让我们修改消息
- 在
extension.ts
中将消息从 "Hello World from HelloWorld!" 改为 "Hello VS Code"。 - 在新窗口中运行 Developer: Reload Window。
- 再次运行 Hello World 命令。
您应该会看到更新后的消息。
以下是一些可以尝试的想法
- 在命令面板中给 Hello World 命令一个新的名称。
- 贡献另一个命令,该命令在信息消息中显示当前时间。贡献点是你在
package.json
扩展清单中进行的静态声明,用于扩展 VS Code,例如为你的扩展添加命令、菜单或键绑定。 - 将
vscode.window.showInformationMessage
替换为另一个 VS Code API 调用以显示警告消息。
调试扩展
VS Code 内置的调试功能使调试扩展变得容易。通过点击行旁的边距设置断点,VS Code 将会命中该断点。你可以将鼠标悬停在编辑器中的变量上,或使用左侧的运行和调试视图来检查变量的值。调试控制台允许你评估表达式。
你可以在 Node.js 调试主题中了解更多关于在 VS Code 中调试 Node.js 应用程序的信息。
后续步骤
在下一个主题 扩展结构 中,我们将仔细研究 Hello World
示例的源代码并解释关键概念。
你可以在以下位置找到本教程的源代码:https://github.com/microsoft/vscode-extension-samples/tree/main/helloworld-sample。扩展指南主题包含其他示例,每个示例都演示了不同的 VS Code API 或贡献点,并遵循我们的 UX 指南中的建议。
使用 JavaScript
在本指南中,我们主要介绍如何使用 TypeScript 开发 VS Code 扩展,因为我们认为 TypeScript 为开发 VS Code 扩展提供了最佳体验。但是,如果你更喜欢 JavaScript,仍然可以使用 helloworld-minimal-sample 进行学习。
UX 指南
现在也是回顾我们的 UX 指南的好时机,以便你可以开始设计你的扩展用户界面,使其遵循 VS Code 的最佳实践。