prettier-atom 不生效的主因是缺少本地 prettier 或 parser 插件，需安装 prettier 及对应扩展（如 prettier-plugin-vue），配置 .prettierrc 显式指定 parser，并优先使用项目级配置而非插件界面设置。

安装 prettier-atom 插件后不生效？检查核心依赖是否就位

Atom 本身不内置代码格式化能力，prettier-atom 只是调度器，真正干活的是 prettier CLI 或其 JS 包。常见现象是插件装完、配置也勾了，但按 Ctrl+Alt+B 没反应——大概率是项目里没装 prettier，或全局安装但 Atom 找不到。

实操建议：

Prettier - Code Formatter

Prettier 是一款"有主见的"代码格式化工具，通过解析代码并按照统一规则重新格式化，强制执行一致的代码风格。支持 JavaScript、TypeScript、CSS、SCSS、HTML、Vue、JSON、Markdown、YAML 等多种语言。可配置为保存时自动格式化。

下载

• 优先在项目根目录运行 npm install --save-dev prettier（推荐），prettier-atom 会自动优先使用本地 node_modules/.bin/prettier
• 若用全局安装（npm install -g prettier），需在 prettier-atom 设置页勾选 Use globally installed prettier，并确认 Atom 终端环境变量能访问到它（Mac/Linux 检查 $PATH，Windows 注意 Atom 是否从命令行启动）
• 打开 Atom 开发者工具（Ctr+Shift+I），在 Console 输入 require('prettier')，不报错才说明加载成功

JS/TS/JSON 文件格式化正常，但 Vue/HTML/CSS 不动？确认 parser 和插件链

prettier 默认只处理 .js、.ts、.json 等基础类型。对 .vue、.html、.css 等，必须显式指定 parser，且依赖对应解析插件。

实操建议：

• 确保项目中已安装 prettier-plugin-vue（Vue）、@prettier/plugin-html（HTML）、@prettier/plugin-css（CSS）等扩展包
• 在项目根目录添加 .prettierrc，明确声明 parser：

  {
    "parser": "vue",
    "plugins": ["prettier-plugin-vue"]
  }

  （Vue 单文件组件）
• Atom 的 prettier-atom 设置页要开启 Format on Save 和 Enable for files with these extensions，手动补全 .vue,.html,.css 等后缀

格式化结果和团队 Prettier 配置不一致？别只改 Atom 设置，以项目配置为准

prettier-atom 的图形界面设置（如 tabWidth、semi）只是 fallback。只要项目目录下存在 .prettierrc、prettier.config.js 或 package.json 中的 prettier 字段，插件就会优先读取它们——界面设置会被完全忽略。

实操建议：

• 删掉 prettier-atom 设置页里所有自定义选项，专注维护项目级配置文件，避免“本地看着对、CI 报错”的情况
• 用 npx prettier --write src/**/*.{js,vue,css} 手动跑一次，验证配置是否真被识别；如果报错，说明 prettier 本身加载失败，不是 Atom 插件问题
• 注意 prettier.config.js 必须导出对象或 Promise，不能写成 module.exports = { semi: true } 以外的语法（比如顶层 await 会崩）

保存时卡顿或格式化错误？关掉“format on save”里的干扰项

Atom 启用 Format on Save 后，如果同时开了 ESLint 自动修复（linter-eslint + eslint-config-prettier 冲突）、或文件过大（>1MB）、或配置了 eslintIntegration 但 ESLint 规则和 Prettier 冲突，会导致保存延迟甚至崩溃。

实操建议：

• 在 prettier-atom 设置中关闭 ESLint Integration，改用 eslint-config-prettier 关闭 ESLint 的格式化规则，让 Prettier 专注格式，ESLint 专注逻辑
• 大文件（如生成的 JSON、打包后的 JS）加到 .prettierignore，避免每次保存都触发解析
• 如果仍卡顿，临时禁用其他 linting 插件，确认是否为插件间资源争抢

Atom 的 prettier-atom 插件本质是轻量胶水，它的稳定高度依赖项目本地环境和配置文件的精确性。最容易被跳过的点：没装本地 prettier、.prettierrc 语法错误、Vue/HTML 等扩展没配 parser 插件——这些问题不会报红字，只会静默失效。