Introduction

Yes, FileOutputStream will create the target file if it does not already exist, as long as the parent directory exists and your process has permission to write there. The important distinction is that FileOutputStream can create the file itself, but it will not create missing directories in the path.

Create the File by Opening the Stream

The simplest example is just to open a FileOutputStream and write bytes.

1import java.io.FileOutputStream;
2import java.io.IOException;
3import java.nio.charset.StandardCharsets;
4
5public class Demo {
6    public static void main(String[] args) throws IOException {
7        try (FileOutputStream out = new FileOutputStream("example.txt")) {
8            out.write("Hello\n".getBytes(StandardCharsets.UTF_8));
9        }
10    }
11}

If example.txt does not exist, Java creates it. If it already exists, the default constructor truncates and overwrites it.

Use Append Mode When You Do Not Want Truncation

If your goal is "create if missing, otherwise keep existing content and append," use the constructor with the append flag.

try (FileOutputStream out = new FileOutputStream("example.txt", true)) {
    out.write("More data\n".getBytes(StandardCharsets.UTF_8));
}

This still creates the file if needed, but it does not wipe the existing content first.

Create Parent Directories Separately

FileOutputStream can create the file, but it cannot invent missing directories for you. If the parent path does not exist, the constructor fails.

1import java.io.File;
2import java.io.FileOutputStream;
3import java.io.IOException;
4
5File file = new File("output/reports/example.txt");
6File parent = file.getParentFile();
7
8if (parent != null) {
9    parent.mkdirs();
10}
11
12try (FileOutputStream out = new FileOutputStream(file)) {
13    out.write("Created with directories\n".getBytes());
14}

That extra directory step is usually what people mean when they say "create if not exists" and then get confused when the code still throws an exception.

Prefer NIO for More Explicit File Creation

If you want more control, java.nio.file.Files can make the intent clearer.

1import java.nio.charset.StandardCharsets;
2import java.nio.file.Files;
3import java.nio.file.Path;
4import java.nio.file.StandardOpenOption;
5
6Path path = Path.of("output/data.txt");
7Files.createDirectories(path.getParent());
8Files.writeString(
9    path,
10    "Hello from NIO\n",
11    StandardCharsets.UTF_8,
12    StandardOpenOption.CREATE,
13    StandardOpenOption.APPEND
14);

For newer Java code, NIO is often easier to read than low-level stream constructors.

Choose Based on What You Mean by "Create"

There are really three different requirements:

• create the file if missing
• create missing directories too
• create only if missing, without overwriting

FileOutputStream only solves part of that story. Make sure the code matches the exact behavior you need.

Charset Choice Matters for Text Output

If you are writing text rather than raw binary data, specify the encoding intentionally. Silent reliance on platform defaults can make file contents inconsistent across machines and deployment environments.

Close Streams Reliably

Use try-with-resources whenever possible. File creation may succeed even if later writes fail, so deterministic closing is important for flushing data and releasing file handles cleanly.

That matters in long-running services.

It also improves correctness.

Common Pitfalls

• Assuming FileOutputStream creates missing parent directories.
• Forgetting that the default constructor truncates existing files.
• Writing text without specifying a character encoding explicitly.
• Using legacy IO when NIO would express the file-creation intent more clearly.
• Treating "file exists" and "path is writable" as if they were the same condition.

Summary

• 'FileOutputStream creates the file automatically if it does not already exist.'
• It does not create missing directories in the path.
• By default it overwrites existing files, unless you use append mode.
• Use NIO when you want more explicit control over file creation behavior.
• Be precise about whether you need file creation, directory creation, append behavior, or all three.