Prettier 是一个主流的 JavaScript 代码格式化工具,可显著提升代码可读性和团队协作效率,通过自动化处理空格、换行、引号等格式问题,减少风格争议。 以下是其核心使用方法与配置指南:
一、安装与版本控制- 推荐本地安装:通过 npm install --save-dev prettier 或 yarn add --dev prettier 将 Prettier 安装到项目依赖中,避免全局安装导致的版本不一致问题。
- 多语言支持:除 JavaScript 外,Prettier 还支持 TypeScript、HTML、CSS、JSON 等语言,适合全栈项目统一格式化。
二、配置规则通过配置文件自定义格式化规则,支持以下两种格式:
- JSON 格式(.prettierrc)
- JavaScript 格式(prettier.config.js)
常用配置项:
示例配置:
{ "semi": true, "singleQuote": true, "trailingComma": "es5", "printWidth": 100, "tabWidth": 4}三、编辑器集成(以 VS Code 为例)- 安装扩展:在扩展市场搜索并安装 Prettier - Code formatter。
- 启用保存时自动格式化:
打开设置(Ctrl + ,),搜索 Format On Save 并勾选。
设置默认格式化工具为 Prettier:搜索 Default Formatter,选择 Prettier - Code formatter。
- 效果:保存文件时,Prettier 会自动根据配置规则格式化代码。
四、与 ESLint 协同工作若项目同时使用 ESLint,需解决两者规则冲突,实现分工:
- ESLint:负责代码质量检查(如未使用变量、潜在错误等)。
- Prettier:仅负责代码风格统一(如空格、引号、换行等)。
配置步骤:
- 安装依赖:npm install --save-dev eslint-config-prettier
- 修改 .eslintrc:{ "extends": [ "eslint:recommended", "prettier", // 禁用所有与 Prettier 冲突的 ESLint 规则 "plugin:prettier/recommended" // 启用 Prettier 插件的推荐规则 ]}
- 效果:ESLint 警告与 Prettier 格式化错误将分开显示,避免重复报错。
五、核心优势- 减少争议:统一团队代码风格,避免因格式问题产生代码审查分歧。
- 提升效率:自动化格式化节省手动调整时间,尤其适合大型项目或多人协作。
- 易用性:低配置门槛,默认规则已覆盖大多数场景,支持快速上手。
六、注意事项- 配置覆盖:项目根目录的配置文件优先级高于用户全局配置。
- 格式化范围:Prettier 默认格式化整个文件,若需部分格式化,需结合编辑器插件或命令行参数。
- 版本兼容性:确保 Prettier 与 ESLint 插件版本兼容,避免规则冲突。
通过合理配置 Prettier,可实现代码风格的高度一致性,显著提升开发体验与项目维护性。