vscode需手动关联.wxml/.wxss文件类型并配置类型定义与格式化器：在settings.json中添加".wxml": "html"、".wxss": "css"；安装minapp插件并确保project.config.json存在；引入api-typings至types目录并配置typeroots；禁用prettier对wxml的默认格式化。
VSCode 识别 .wxml/.wxss 文件必须手动关联类型
VSCode 默认不认 .wxml 和 .wxss，打开就是纯文本，没高亮、没缩进、没折叠——这不是插件没装对，是 VSCode 根本没把它们当“代码文件”处理。
实操建议：
- 打开 VSCode 设置（
Ctrl+,），搜索files.associations - 点击“在 settings.json 中编辑”，添加两行：
"*.wxml": "html", "*.wxss": "css"
这样 VSCode 就会用 HTML/CSS 的语法引擎渲染它们，基础高亮、属性提示、格式化立刻可用。别信某些插件说“自动搞定”，这步跳过，后面所有智能提示都打折扣。
minapp 插件是目前最稳的 API + 标签双补全方案
搜“微信小程序 VSCode 插件”会出现一堆名字带 wechat、wxapp 的，但多数已停更或只做高亮。真正持续维护、覆盖完整场景的只有 minapp（作者：qiu8310）。
它解决两个核心问题：
-
wx.request、Page、Component等全局对象和 API 的 TypeScript 式补全（含参数说明） -
<view></view>、<button></button>等组件标签 + 属性（如bindtap、data-）的实时触发补全 - 同时支持原生、
mpvue、wepy项目，不用为框架切插件
注意：安装后需重启 VSCode，且确保项目里有 project.config.json——否则插件可能降级为仅语法高亮模式。
wxapi 提示失效？大概率是没配好类型定义
装了插件却输 wx. 没反应？不是插件坏了，是 VSCode 没拿到微信官方的类型声明。
微信维护的 api-typings 仓库才是源头活水，minapp 和 vscode-weapp-api 都依赖它。
实操建议：
- 去 GitHub 克隆或下载
https://github.com/wechat-miniprogram/api-typings - 在项目根目录建
types文件夹，把解压后的index.d.ts放进去 - 在项目根目录加
jsconfig.json（JS 项目）或tsconfig.json（TS 项目），确保包含：
{
"compilerOptions": {
"typeRoots": ["./types", "./node_modules/@types"]
}
}
做完这步，wx.getSystemInfo 不仅能补全，还能悬停看参数类型和返回结构。
格式化 wxml 时容易把自定义属性弄错
wxml 里大量使用 bind:xxx、data-xxx、model:value 这类非标准 HTML 属性，而 VSCode 默认的 HTML 格式化器（如 Prettier）会把它们当成非法属性删掉或重排，导致编译报错。
解决方案只有两个：
- 禁用 Prettier 对
.wxml的接管：在settings.json中加
"[wxml]": {
"editor.defaultFormatter": null
}
- 改用专为小程序优化的格式化器，比如
wxml插件（注意不是vscode-wxml，后者已弃用），它能保留冒号语法和data-前缀
这个坑几乎每个换编辑器的新手都会踩一次，尤其当 bind:touchstart 被格式化成 bindtouchstart 后，事件直接失灵，调试半天才发现是格式化器干的。
类型定义要放对位置，文件关联不能跳过，格式化器得按文件类型开关——这些都不是“高级技巧”，而是写第一行 wx.login 前就得设好的底线。
