快速开始

推荐的设置和常见工作流。

安装

将 oxfmt 安装为开发依赖：

npm

$ npm add -D oxfmt

pnpm

$ pnpm add -D oxfmt

yarn

$ yarn add -D oxfmt

bun

$ bun add -D oxfmt

将脚本添加到 package.json：

package.json

{
  "scripts": {
    "fmt": "oxfmt",
    "fmt:check": "oxfmt --check"
  }
}

格式化文件：

npm

npm run fmt

pnpm

pnpm run fmt

yarn

yarn run fmt

bun

bun run fmt

检查格式化而不写入文件：

npm

npm run fmt:check

pnpm

pnpm run fmt:check

yarn

yarn run fmt:check

bun

bun run fmt:check

用法

oxfmt [OPTIONS] [PATH]...

不带参数运行 oxfmt 会格式化当前目录（相当于 prettier --write .）。

不支持像 --no-semi 这样的 CLI 选项。请使用配置文件来确保 CLI 和编辑器集成之间的设置一致。

要在位置路径中使用 glob 模式，请务必将它们用引号括起来。否则，它们可能会也可能不会根据您的环境进行展开。

有关选项的完整列表，请参阅 CLI 参考。

常见工作流

与 lint-staged 一起进行预提交

package.json

{
  "lint-staged": {
    "*": "oxfmt --no-error-on-unmatched-pattern"
  }
}

--no-error-on-unmatched-pattern 在没有文件匹配模式时防止报错。

创建配置文件

使用默认值初始化 .oxfmtrc.json：

oxfmt --init

从 Prettier 迁移

oxfmt --migrate prettier

详见 从 prettier 迁移。

列出不同的文件

oxfmt --list-different

这对于配置 要忽略的文件 很有用。

管道传输文件内容

echo 'const   x   =   1' | oxfmt --stdin-filepath test.ts

输出 const x = 1;

Node.js API

import { format, type FormatOptions } from "oxfmt";

const input = `let a=42;`;
const options: FormatOptions = {
  semi: false,
};

const { code } = await format("a.js", input, options);
console.log(code); // "let a = 42"

下一步

• 更改配置
• 设置编辑器
• 设置 CI
• 学习高级功能：排序、嵌入格式化
• 兼容性矩阵
• 查看 CLI 参考