麻雀（Sparrow）

轻量、高效的 VS Code 扩展

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

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

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

项目介绍

适用场景

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

核心能力

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

功能清单

1. 微信小程序基础支持

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

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

• [x] axml（.axml 语言与语法支持）
• [x] acss（.acss 语言与语法支持）
• [x] sjs（.sjs 语言映射）

安装与启用

方式一：从扩展市场安装

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

方式二：本地打包安装

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

bun run build

3. 生成 .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. OXC 格式化器配置

• oxc.fmt.configPath: .oxfmtrc.json

6. 编辑器通用编辑体验优化

• editor.defaultFormatter: esbenp.prettier-vscode（全局默认格式化器）
• editor.fontLigatures: true（启用字体连字）
• editor.formatOnPaste: true（粘贴时自动格式化）
• editor.formatOnSave: true（保存时自动格式化）
• editor.linkedEditing: true（启用关联编辑）
• editor.semanticTokenColorCustomizations：针对以下内容启用斜体
  • *.static、interface、keyword、selfParameter
• editor.tokenColorCustomizations：通过 TextMate 规则为以下项启用斜体
  • 布尔常量：constant.language.boolean
  • 未定义/空值：constant.language.undefined、constant.language.null、constant.language.nullptr
  • 类型操作符：meta.type keyword.operator.expression.typeof、meta.type keyword.operator.expression.keyof
  • 关键字：keyword.control、keyword.function、keyword.operator.new、keyword.operator.borrow.and.rust
  • 存储类型：storage.type、storage.modifier
  • 语言变量：variable.language.this
  • 标记：markup.italic

7. 文件和资源配置

• explorer.fileNesting.enabled: true（启用文件嵌套显示）
• files.readonlyInclude：将 Cargo 和 Rust 库文件标记为只读

8. Git 相关配置

• git.allowForcePush: true（允许强制推送）
• git.autofetch: true（启用自动获取）
• git.blame.editorDecoration.enabled: true（显示 Git Blame）
• git.pruneOnFetch: true（获取时清理远程追踪分支）
• git.rebaseWhenSync: true（同步时使用变基）

9. 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 功能重新启用时使用

10. 国际化配置（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

11. 终端配置

• terminal.integrated.fontLigatures.enabled: true（启用终端字体连字）

12. 窗口配置

• 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