// prettier-ignore需独占一行置于目标行正上方，仅忽略下一行；块级忽略用/ prettier-ignore /包裹整个语法节点，jsx中需加花括号；失效主因是格式化器冲突或配置错误。

怎么用 // prettier-ignore 跳过单行格式化

直接在要忽略的那行代码**正上方**加注释 // prettier-ignore，Prettier 就会跳过紧跟着的那行。它只作用于下一行，不跨行、不累积。

常见错误是把它写在行尾或放在多行语句中间——那样完全无效。

• // prettier-ignore 必须独占一行，且不能有其他内容（包括空格）
• 对对象字面量、数组、JSX 等复杂结构也只忽略“那一行”，如果结构跨多行，需在每行前都加（不推荐），更稳妥的做法是忽略整个块
• 示例：

  // prettier-ignore
  const longLine = "this will not be wrapped even if it exceeds printWidth";

怎么忽略一个代码块（比如整个对象或函数）

用 {/* prettier-ignore */}（JSX）或 /* prettier-ignore */（JS/TS）包裹目标块，注意这是块级注释，不是行注释。

容易踩坑的是：括号位置不对、漏掉星号、或误写成 // prettier-ignore —— 后者对块无效。

• JS/TS 中：

  /* prettier-ignore */
  const config = {
    some: "very",
    long: "object",
    that: "must stay exactly like this"
  };

• JSX 中必须用花括号包裹注释：

  <div>
    {/* prettier-ignore */}
    <table><tr><td>raw html</td></tr></table>
  </div>

• 该注释会影响整个被包裹的语法节点，包括其子节点

为什么 prettier-ignore 有时不起作用

最常见原因是 VSCode 没有真正调用 Prettier 做保存时格式化，而是用了其他格式化工具（比如 ESLint 的 fix-on-save 或内置 JS 格式化器）。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

检查你当前文件的右下角语言模式是否匹配 Prettier 支持的语言，并确认设置没冲突。

• 确认 "editor.formatOnSave" 是 true
• 确认 "editor.defaultFormatter" 对应语言设为了 esbenp.prettier-vscode
• 检查有没有启用 "eslint.format.enable" 且优先级更高 —— 它会覆盖 Prettier
• 如果用了 prettier.config.js，确保其中没禁用 ignorePath 或误配了 overrides

还有没有更“硬核”的绕过方式

可以临时关掉 Prettier 的保存格式化，但只建议调试用；长期靠这个，说明项目配置或代码结构本身可能需要调整。

比起到处加 ignore 注释，更值得花时间确认：是不是 printWidth 设得太小？是不是用了不兼容的插件（比如某些模板字符串美化插件）？

• 快捷键临时禁用：Ctrl+Shift+P → 输入 Format Document → 选中后按 Ctrl+Shift+P 再输入 Disable Formatting（仅本次生效）
• 在 .prettierrc 里加 "bracketSameLine": true 有时比 ignore 更干净地解决 JSX 换行问题
• 真正难搞的场景（比如内联 SVG、手写 AST 相关代码），ignore 是合理选择，但得接受它会让代码可维护性打折扣

ignore 注释不是补丁，是显式声明“这里我负责格式”。一旦多了，就得回头看看是不是规则或协作约定该调了。