무시 파일

Oxfmt는 포맷에서 제외할 파일을 여러 방식으로 지정할 수 있습니다.

무시 메커니즘은 전역으로 적용되는 것과 설정 파일에 묶이는 것이 있습니다.

메커니즘	범위
! 접두사가 붙은 CLI 경로	전역
.prettierignore / --ignore-path	전역
설정의 ignorePatterns	해당 설정에 한정

중첩 설정을 쓰는 경우 ignorePatterns는 그 설정 파일에 따라 해석된 파일에만 적용됩니다. 전역 메커니즘은 어떤 설정이 적용되든 항상 적용됩니다.

ignorePatterns

파일을 무시하는 권장 방법입니다. Oxfmt 설정에 추가합니다.

.oxfmtrc.json

{
  "ignorePatterns": ["dist/**", "*.min.js"]
}

oxfmt.config.ts

import { defineConfig } from "oxfmt";

export default defineConfig({
  ignorePatterns: ["dist/**", "*.min.js"],
});

• .gitignore 구문 사용
• 경로는 Oxfmt 설정 파일이 있는 디렉터리 기준으로 해석
• Git과 별개의 포매터 전용 설정

ignorePatterns에 맞는 파일은 명시적으로 지정해도 포맷되지 않습니다.

.gitignore

Oxfmt는 현재 디렉터리 트리의 .gitignore를 준수합니다.

• 전역 gitignore와 상위 .gitignore는 읽지 않음
• .git 디렉터리가 없어도 됨

.gitignore로 무시된 파일도 명시적으로 지정하면 포맷할 수 있습니다.

VCS 디렉터리와 node_modules

기본으로 무시: .git, .svn, .jj, node_modules

node_modules까지 포함하려면 --with-node-modules를 사용하세요.

잠금 파일

package-lock.json, pnpm-lock.yaml 등은 항상 무시됩니다.

.prettierignore

Prettier 호환을 위해 지원합니다. .gitignore 구문을 사용합니다.

.prettierignore에 있는 파일은 명시적으로 지정해도 포맷할 수 없습니다.

새 프로젝트에서는 ignorePatterns 사용을 권장합니다.