插件安装后必须重启HBuilderX才生效，否则右下角无绿色指示器、Ctrl+S无反应；需关闭原生格式化避免冲突；必须勾选“使用项目根目录下的配置文件”并确保.prettierrc.js位置正确且语法合法。
插件安装后必须重启HBuilderX才生效
很多人装完Prettier插件发现右下角没出现绿色状态指示器，或者Ctrl+S没反应，根本原因是没重启。HBuilderX的插件机制要求显式重启才能加载新插件的全部能力——不是“安装完就自动可用”。
安装路径是：工具 → 插件安装 → 搜索 Prettier → 选官方版本（DCloud或Prettier官方发布）→ 安装 → 弹窗提示“重启生效”时务必点确认。
重启后检查右下角状态栏，看到 Prettier 字样且为绿色，才算真正就位。
必须关闭HBuilderX原生格式化，否则冲突
默认开启的编辑器格式化会抢在Prettier前执行，导致配置失效、缩进错乱、甚至报错 Cannot read property 'rangeStart' of undefined。
关闭方法：
• 工具 → 设置 → 编辑器设置
• 找到 editor.formatOnSave，设为 false
• 找到 editor.defaultFormatter，设为 null 或留空
• 保存后，再测试保存操作是否触发的是Prettier而不是内置格式器
.prettierrc.js 配置文件要放对位置且启用项目级读取
插件默认不读取项目根目录下的配置，必须手动勾选“使用项目根目录下的配置文件”，否则所有规则都按插件内置默认值走，比如 semi: true 你改了也没用。
路径：
• 工具 → 设置 → 插件配置 → PrettierFormator
• 勾选 使用项目根目录下的配置文件
• 确保项目根目录存在 .prettierrc.js 或 .prettierrc
常见坑：
• 文件名写成 prettier.config.js（Prettier不识别）
• 放在子目录里（必须在项目最外层）
• 使用 .prettierrc JSON格式却加了注释（JSON不允许注释，会直接报错解析失败）
HBuilderX 是由 DCloud 推出的一款轻量级前端开发工具，在 Linux 系统上主要用于 Web 开发与跨平台应用开发，尤其适合 Vue 和 uni-app 相关项目。
Vue/UniApp中属性换行要用 singleAttributePerLine
默认Prettier对HTML/Vue标签的属性处理是“能压一行就压一行”，但团队协作或可读性要求高时，需要每个属性独占一行。这不是靠 printWidth 调整能解决的，必须显式开启：singleAttributePerLine: true
这个选项只在 .prettierrc.js 中有效，不能通过插件UI界面配置。
示例配置片段：
module.exports = {<br> singleAttributePerLine: true,<br> printWidth: 120,<br> tabWidth: 2,<br> semi: false,<br> singleQuote: true<br>};注意：该选项对
.vue 的 <template> 和 <script> 都生效，但对 .nvue 文件需确认插件支持版本（2026年主流版本已支持）
最容易被忽略的是插件配置页里那个“使用项目根目录下的配置文件”开关——它默认是关的，而绝大多数人以为装完插件、写好配置就万事大吉。这个开关不打开，你改十遍 .prettierrc.js 都白搭。
