必须安装minapp-vscode或wxml扩展才能实现微信小程序自定义组件.wxml语法高亮和补全，前者支持最新语法及别名配置，后者轻量但别名支持弱；路径需正确、大小写一致、.json含component:true，事件补全依赖triggerevent字面量和jsdoc注释。
微信小程序自定义组件的 .wxml 文件没高亮？装对扩展是前提
VSCode 默认不识别微信小程序的自定义组件语法（比如 <custom-comp></custom-comp>、bind:customevent），也不会解析 component 目录下的 .json 声明。核心问题不是 VSCode 不行，而是缺了能理解小程序 DSL 的语言服务。
必须安装 minapp-vscode（官方推荐）或 WXML 扩展（由微信团队维护）。前者更活跃，支持最新基础库语法和自定义组件自动注册识别；后者轻量但对 usingComponents 路径别名（如 ~ 或 @/components）支持较弱。
- 卸载所有名字含 “wechat”、“weapp” 但非官方/非
minapp-vscode的扩展，避免语法冲突 - 安装后重启 VSCode，打开任意
.wxml文件，右下角状态栏应显示 “WXML” 语言模式（不是 “Plain Text” 或 “HTML”） - 如果仍不生效，检查文件关联：右键 → “Change Language Mode” → 手动选 “WXML”
usingComponents 路径写错，补全直接失效
自定义组件补全依赖 VSCode 能准确解析 json 中的 usingComponents 字段，并映射到对应 .wxml 和 .js 文件。路径错误、大小写不一致、别名未配置，都会导致补全“看不见”组件。
常见错误现象：<my-button></my-button> 输入时无提示；输入 bind:click 后没有对应事件方法补全；组件属性 hover 不显示文档。
- 路径必须是相对路径，从当前
.json文件出发，不能用/开头（即不支持绝对路径） - 确保路径拼写与磁盘实际文件名完全一致（Windows 下不区分大小写，但 macOS/Linux 区分）
- 若用了构建工具 alias（如
@/components/button），minapp-vscode默认不识别，需在项目根目录加minapp.config.js配置alias - 组件
.json必须有component: true字段，否则不被识别为可复用组件
自定义组件事件补全靠 behaviors 和 properties 定义
VSCode 补全 bind:xxx 事件，不是靠猜，而是读取组件 .js 中 behaviors 引入的行为、以及 properties 类型推导出的事件名。如果组件没显式声明事件触发逻辑，补全就空着。
例如：一个按钮组件想让使用者能 bind:confirm，它自己得在 methods 里调用 this.triggerEvent('confirm')，且最好在 properties 或注释中说明该事件。
- 补全不会识别
triggerEvent里拼接的字符串（如this.triggerEvent(type + 'ed')），只认字面量 - 使用
behaviors复用事件逻辑时，确保 behavior 文件本身也符合小程序组件规范（含behavior()调用、triggerEvent显式调用） - 如果事件名带连字符（如
bind:price-change），组件内必须用引号包裹：this.triggerEvent('price-change')，否则解析失败
TS 支持弱？给 .ts 组件加 JSDoc 是最稳的补全方式
目前 minapp-vscode 对 TypeScript 的 Component 构造函数类型推导有限，尤其在泛型或复杂 properties 类型时容易漏补全。纯靠类型系统不够可靠，JSDoc 是更可控的补充手段。
比如想让使用者输入 props="{{item}}" 时提示 item 应为 {id: number, name: string} 类型，光写 properties: { item: Object } 不够清晰。
- 在
properties字段上方加 JSDoc 注释：/** @type {{id: number, name: string}} */ - 为
triggerEvent添加注释：/** @event confirm 点击确认按钮时触发 */ - 确保组件
.ts文件顶部有/** @typedef {import('./types').CustomProps} Props */这类引用，帮助扩展定位类型定义 - 避免在
properties里用Any或Object，尽量拆解为具体字段，否则补全和校验都失效
真正卡住补全的，往往不是扩展没装，而是路径、命名、注释这三个地方差了一点点。尤其是团队协作时，一个人改了 usingComponents 路径但没同步文档，其他人就会反复遇到“明明写了却没提示”的问题。
