应分别配置HBuilderX与VS Code的语法校验：HBuilderX需关闭Vue语法校验或右键停用单文件校验，VS Code需正确安装@vue/eslint-parser、eslint-plugin-vue及eslint-plugin-uni，并在.eslintrc.js中指定parser为'@vue/eslint-parser'，禁用误报规则。
直接关掉编辑器的语法检查不是推荐做法，真正该做的是让检查「只报真问题」——比如变量未定义、API 调用错误，而不是因为 // #ifdef H5 或 <script setup> 语法被误判为错误。HBuilderX 和 VS Code 的处理逻辑不同，得分开看。
VS Code 中 ESLint 报错但代码能跑，怎么关掉干扰项
这不是“关语法检查”，而是关掉 ESLint 对 uni-app 特有语法的误报。常见现象：打开 .vue 文件就红波浪线标出 Parse error: Unexpected token，实际是 ESLint 没配对 vue 解析器或插件版本错。
- 确认已安装
@vue/eslint-parser（Vue 3 项目必须用 v9+）和eslint-plugin-vue（v9+），旧版不识别<script setup> -
.eslintrc.js中parser必须设为'@vue/eslint-parser'，不能是'espree'或留空 - 在
rules里显式关掉对条件编译的误伤："no-unused-expressions": ["error", { "allowTaggedTemplates": true }]，否则//#ifdef后的模板字符串会被当语法错误 - 禁用 Vetur 插件——它和 ESLint + Prettier 冲突，尤其在
<template>块里会重复报错
HBuilderX 里红色波浪线停不下来，怎么临时屏蔽
HBuilderX 自带的语法校验无法彻底关闭，但可以绕过大部分误报。它底层调用的是内置的 Vue 解析器，对 uni-app 条件编译支持较弱，容易把 // #ifdef MP-WEIXIN 当注释外内容报错。
- 右键编辑器 → 「停止当前文件语法校验」可临时隐藏波浪线（仅当前文件生效）
- 全局关闭不现实，但可在「设置 → 编辑器 → 代码提示」里把「Vue 语法校验」勾选去掉（会影响组件名自动补全，慎用）
- 更稳妥的做法：确保项目根目录有正确
jsconfig.json或tsconfig.json，且compilerOptions.types包含"@dcloudio/types"，否则 HBuilderX 无法识别uni.xxxAPI - 如果波浪线集中在
<style scoped>里的lang="scss"，检查是否装了 Sass 插件；没装的话，HBuilderX 会把@import当 JS 语法报错
为什么不能直接禁用 ESLint 或关掉所有提示
关掉检查看似省事，实则埋雷。uni-app 的跨平台特性决定了很多错误只在特定平台暴露——比如 uni.getSystemInfoSync() 在 H5 可用，但在小程序里必须异步调用；ESLint 如果没启用 eslint-plugin-uni，这类平台差异根本不会提醒你。
-
eslint-plugin-uni是官方维护的规则集，能检测uni.navigateTo是否漏传url、pages.json路径是否真实存在等硬性约束 - 完全禁用后，
console.log漏删、undefined变量引用、拼错的uni.hideToast都得等到真机运行才暴露，调试成本翻倍 - 团队协作时，靠人眼守规则不可持续；保留 ESLint 但精准配置，才是长期省事的做法
最易被忽略的一点：HBuilderX 的语法校验和 VS Code 的 ESLint 校验是两套机制，各自读各自的配置。你在 VS Code 里配好了 parser 和 plugins，HBuilderX 不认；反过来也一样。别指望一个配置打遍天下，得按编辑器分别处理。
