How to Remove Empty Directories Portably: Scripts and Best Practices

Empty directories accumulate over time from installs, builds, version-control operations, and file moves. Removing them cleans repositories, reduces clutter, and can speed file searches and backups. This guide shows portable, cross-platform approaches—POSIX shells, PowerShell, and a tiny Python script—plus best practices to avoid data loss.

When to remove empty directories

Cleanup after builds, installs, or package managers.
Preparing archives or backups to reduce size.
Tidying repositories before publishing or committing.

Safety first — best practices

Backup: Run operations on a copy or ensure recent backups exist for important data.
Dry run: Always preview what will be removed before deleting.
Ignore special directories: Skip version-control folders (e.g., .git), system folders, or directories with metadata you want preserved.
Permission checks: Run as an appropriate user; avoid running broad deletions as root/Administrator.
Logging: Record deleted paths to a log file for auditing and recovery.

Portable methods (POSIX shell, PowerShell, Python)

1) POSIX shell (Linux, macOS, WSL, Git Bash)

Use find to detect empty directories. This version is portable across most UNIX-like environments.

Dry run (list only):

Code
find /path/to/dir -type d -empty -print

Delete safely (skip .git):

Code
find /path/to/dir -type d -empty -not -path “/.git/” -print -delete

Notes:

-empty matches directories with no entries (only works on filesystems that report correctly).
-delete removes as it finds them; using -print first shows what will be removed.
If your find lacks -delete, pipe to xargs:

Code
find /path/to/dir -type d -empty -not -path “/.git/” -print0 | xargs -0 rmdir

2) Windows PowerShell (cross-platform PowerShell Core)

PowerShell works on Windows, Linux, and macOS when PowerShell Core is installed.

Dry run (list):

Code
Get-ChildItem -Path ‘C:\path\to\dir’ -Directory -Recurse | Where-Object { @(Get-ChildItem -LiteralPath \(_.FullName -Force) -eq \)null } | Select-Object FullName

Delete (skip .git): “

How to Remove Empty Directories Portably: Scripts and Best Practices