vscode需手动关联.wxml为wxml语言模式并安装minapp-vscode插件，否则无高亮补全；格式化须禁用prettier并指定专用formatter；自定义组件补全依赖component.json、usingcomponents路径准确及triggerevent字面量调用。

VSCode 默认不识别 .wxml 文件，必须手动关联语言模式

打开任意 .wxml 文件，右下角显示 “Plain Text” 或 “HTML” 就说明没生效——这不是插件问题，是 VSCode 根本没把它当 WXML 处理。不解决这步，后续所有高亮、补全、格式化都会失效。

实操建议：

• 按 Ctrl+, 打开设置，搜索 files.associations，点击“在 settings.json 中编辑”
• 添加这一行："*.wxml": "wxml"（注意不是 "html"）
• 重启 VSCode 或重载窗口（Ctrl+Shift+P → Developer: Reload Window）
• 再打开 .wxml 文件，右下角应显示 “WXML” 语言模式

装 minapp-vscode 插件，别用名字带 “wechat” 的旧插件

minapp-vscode（作者 qiu8310）是目前唯一持续维护、同时支持标签补全（如 <view></view>、bindtap）和 API 补全（如 wx.request、Page）的插件。其他标榜“微信小程序”的插件多数已停更，或只做基础高亮。

关键前提：

• 项目根目录必须有 project.config.json，否则插件降级为仅语法高亮
• 卸载所有非官方、非 minapp-vscode 的同类插件（比如 wechat-snippet、vscodewxml），避免语言服务冲突
• 自定义组件补全依赖 usingComponents 路径正确且大小写一致；路径不能以 / 开头，不支持构建 alias（如 @/components），需额外配 minapp.config.js

WXML 格式化必须指定专用 formatter，禁用 Prettier 干预

VSCode 默认没有 WXML 格式化能力，且 Prettier 会强行按 JS 规则处理 .wxml，导致标签错位、属性挤成一行、<block></block> 被破坏等。

微信创作

自动将 Markdown 文章转为适配微信公众号格式的 HTML，并批量发布至公众号草稿箱，支持封面图生成与专题管理。

下载

正确做法：

• 安装 wechat-snippet（专注 WXML 结构）或 XML Tools（通用但需手动设语言模式为 XML）
• 在设置中搜索 default formatter，为 wxml 文件类型指定上述插件
• 项目根目录加 .prettierrc，内容包含：{"ignore": ["**/*.wxml", "**/*.wxss"]}
• 如果用了 redhat.vscode-xml，它不支持 WXML，会报 Language client is not ready yet 错误，务必卸载

自定义组件标签不补全？检查 component.json 和 triggerEvent 字面量

输入 <my-comp></my-comp> 没提示，通常不是插件没装，而是 VSCode 没解析到该组件声明。补全逻辑依赖静态分析，不运行时推导。

必须满足：

• component.json 中有 "component": true 字段
• usingComponents 中路径与磁盘文件名完全一致（macOS/Linux 区分大小写）
• 事件补全（如 bind:confirm）只认 this.triggerEvent('confirm') 这种字面量调用，不识别拼接字符串（如 this.triggerEvent(type + 'ed')）
• 若组件使用 behaviors，behavior 文件本身也得是合法组件（含 Behavior() 调用）

路径别名、动态注册、运行时 import 都不会被识别——WXML 补全是静态的，这点容易被忽略。