轻量、高效的 VS Code 扩展

麻雀虽小，五脏俱全。为开发者提供两大核心能力：

📱 小程序开发支持 — 补齐微信、支付宝小程序的语法高亮、代码片段和编辑体验

⚙️ 编辑器配置 — 内置小程序开发最佳实践配置，Prettier 格式化、主题优化等

项目介绍

适用场景

📱 小程序开发者
在 VS Code 中开发微信或支付宝小程序，需要完整的语法支持和开发体验优化

核心能力

微信小程序支持 — WXML 语法、WXSS 样式、WXS 脚本、JSON Schema 校验和代码片段
支付宝小程序支持 — AXML 语法、ACSS 样式、SJS 脚本全套支持
编辑器体验优化 — 智能格式化、主题配色、快捷建议等默认配置，开箱即用

功能清单

1. 微信小程序基础支持

wx-json（常见配置文件 JSON Schema 校验）
wx-snippets（JS / TS / JSON 片段）
wxml-basics（.wxml 基础语法支持）
wxs（.wxs 语言映射）
wxss（.wxss 语言映射）
wxml-language-features

2. 支付宝小程序基础支持

axml（.axml 语言与语法支持）
acss（.acss 语言与语法支持）
sjs（.sjs 语言映射）

安装与启用

方式一：从扩展市场安装

在 VS Code 扩展市场搜索：麻雀 / Sparrow（发布者：ftzahao）。

方式二：本地打包安装

在项目根目录安装依赖（按你的包管理器执行）。
运行打包命令：

bun run build

生成 .vsix 后，在 VS Code 中选择“从 VSIX 安装”。

配置说明

编辑器默认配置（configurationDefaults）

麻雀提供一组编辑器默认项，主要用于提升小程序文件在 VS Code 中的编辑体验。

1. 按语言指定默认格式化器

[rust].editor.defaultFormatter: rust-lang.rust-analyzer
[toml].editor.defaultFormatter: tombi-toml.tombi
[wxml].editor.defaultFormatter: esbenp.prettier-vscode
[wxss].editor.defaultFormatter: esbenp.prettier-vscode
[wxs].editor.defaultFormatter: esbenp.prettier-vscode
[axml].editor.defaultFormatter: esbenp.prettier-vscode
[acss].editor.defaultFormatter: esbenp.prettier-vscode
[sjs].editor.defaultFormatter: esbenp.prettier-vscode

2. AXML 编辑体验优化

[axml].editor.semanticHighlighting.enabled: false
[axml].editor.quickSuggestions.other: true
[axml].editor.quickSuggestions.strings: true
[axml].editor.quickSuggestions.comments: false

3. Prettier 配置

prettier.documentSelectors：识别小程序文件
- **/*.{wxml}、**/*.{wxss}、**/*.{wxs}：微信小程序
- **/*.{axml}、**/*.{acss}、**/*.{sjs}：支付宝小程序
prettier.printWidth: 100
prettier.semi: false
prettier.trailingComma: none

4. 样式语法检查兼容

css.lint.unknownAtRules: ignore
less.lint.unknownAtRules: ignore
scss.lint.unknownAtRules: ignore

5. 文件和资源配置

files.readonlyInclude：将 Cargo 和 Rust 库文件标记为只读

6. GitLens 配置

大多数 GitLens 功能默认关闭，保持编辑器轻量。具体包括：

AI 功能关闭：gitlens.ai.enabled、gitlens.cloudIntegrations.enabled 等
注解功能关闭：gitlens.blame.heatmap.enabled、gitlens.blame.highlight.enabled、gitlens.codeLens.enabled 等
侧边栏和图表功能关闭：gitlens.graph.sidebar.enabled、gitlens.launchpad.indicator.enabled 等
保留基础功能：gitlens.ai.model、gitlens.ai.vscode.model 配置用于 AI 功能重新启用时使用

7. 国际化配置（i18n-ally）

i18n-ally.disabled: true（默认禁用）
i18n-ally.editor.preferEditor: true
i18n-ally.enabledParsers: ["json"]
i18n-ally.extract.autoDetect: true
i18n-ally.keystyle: flat
i18n-ally.namespace: true

8. 窗口配置

window.autoDetectColorScheme: true（自动检测系统配色方案）

说明： 以上为扩展提供的默认值。如果你在用户设置或工作区设置中显式配置了同名项，将以你的手动配置为准。

Prettier 配置建议

在项目根目录创建 .prettierrc，推荐配置如下：

{
  "$schema": "https://json.schemastore.org/prettierrc",
  "semi": false,
  "singleQuote": true,
  "printWidth": 200,
  "overrides": [
    {
      "files": ["*.axml", "*.wxml"],
      "options": {
        "parser": "html"
      }
    },
    {
      "files": ["*.acss", "*.wxss"],
      "options": {
        "parser": "css"
      }
    },
    {
      "files": ["*.sjs", "*.wxs"],
      "options": {
        "trailingComma": "none"
      }
    }
  ]
}

说明：

*.axml、*.wxml 使用 html parser，使 Prettier 能正确格式化支付宝小程序模板文件
*.acss、*.wxss 使用 css parser，使 Prettier 能正确格式化支付宝小程序样式文件
*.sjs、*.wxs 禁用尾逗号，兼容支付宝/微信小程序 SJS、WXS 语法规范

开发说明

入口文件：main.js
构建命令：bun run build（内部执行 vsce package）
打包产物：项目根目录下的 .vsix

仓库

GitHub: https://github.com/ftzahao/sparrow

麻雀