📘 什么是扩展清单?
扩展清单(extension manifest
)是 VSCode 扩展的核心配置文件,通常为 package.json
。它定义了扩展的基本信息、功能、依赖项等。
📋 关键字段说明
name
:扩展唯一标识符(如learn-vscode-helper
)version
:版本号(遵循语义化版本规范)publisher
:发布者名称(如yourname
)main
:主文件路径(如out/extension.js
)activationEvents
:扩展激活事件(如onLanguage:javascript
)contributes
:贡献项(如语法高亮、命令等)
🛠 示例结构
{
"name": "learn-vscode-helper",
"version": "1.0.0",
"publisher": "yourname",
"main": "out/extension.js",
"activationEvents": ["onLanguage:javascript"],
"contributes": {
"commands": [{ "command": "learn-vscode-helper.greet", "title": "Say Hello" }]
}
}
📚 常用配置项
engines
:指定 VSCode 版本要求(如engines.vscode: "1.80.x"
)categories
:分类标签(如category: "Other"
)license
:开源协议(如license: "MIT"
)readme
:扩展说明文档路径(如README.md
)
📌 扩展阅读
想深入了解 VSCode 扩展开发?点击 这里 查看教程。
📌 提示:清单文件需与扩展目录同级,且
name
必须与发布平台一致。