Administración de sistemas · Multiplataforma

Cómo ver el espacio en disco en Windows, Linux y macOS

Usa PowerShell en Windows, df en Linux y macOS, o un comando QZX cuando una automatización necesite datos estructurados en las plataformas compatibles.

Por Alejandro Sánchez, creador de QZX 10 min de lectura
Tres entornos de computadora y almacenamiento envían datos de capacidad a un panel común de espacio usado y libre con salida estructurada.
Capacidad, espacio usado y disponible describen un sistema de archivos. El tamaño de un directorio es una medición relacionada, pero diferente.

Consultar el espacio en disco parece una tarea universal, pero cada sistema operativo expone el almacenamiento mediante comandos y conceptos diferentes. Windows suele presentar letras de unidad y volúmenes. Linux y macOS presentan sistemas de archivos montados bajo un solo árbol de directorios. Contenedores, recursos de red, snapshots, cuotas y espacio reservado añaden variaciones.

La primera pregunta debe ser precisa: ¿necesitas capacidad del sistema de archivos, tamaño de un directorio, archivos más grandes o información del disco físico? Esta guía se centra en capacidad: total, usado, disponible y porcentaje utilizado.

Resumen de comandos

Entorno Comando Mejor uso
Windows PowerShell Get-Volume Metadatos de volúmenes, letras, sistema de archivos, salud, tamaño y espacio restante en Windows.
Proveedor de archivos de PowerShell Get-PSDrive -PSProvider FileSystem Unidades de archivos visibles en la sesión, incluidos Used y Free cuando son compatibles.
Linux df -h Capacidad de sistemas de archivos montados en unidades legibles.
macOS df -h Capacidad desde Terminal; columnas y unidades exactas corresponden a la utilidad BSD del sistema.
QZX qzx getDiskInfo --json Una consulta común con resultados estructurados en entornos Windows, Linux y macOS compatibles.

Cómo ver el espacio en disco en Windows

Get-Volume: inspeccionar volúmenes de Windows

Get-Volume
Get-Volume -DriveLetter C
Get-Volume -DriveLetter C |
  Select-Object DriveLetter, FileSystem, Size, SizeRemaining

Get-Volume pertenece al módulo Storage de Windows y devuelve objetos de volumen, no solo texto formateado. Por eso sirve para filtrar, ordenar, exportar y calcular porcentajes.

Get-Volume -DriveLetter C |
  Select-Object DriveLetter,
    @{Name='SizeGB'; Expression={[math]::Round($_.Size / 1GB, 2)}},
    @{Name='FreeGB'; Expression={[math]::Round($_.SizeRemaining / 1GB, 2)}},
    @{Name='UsedPercent'; Expression={
      [math]::Round((1 - $_.SizeRemaining / $_.Size) * 100, 1)
    }}

El ejemplo calcula campos de presentación sin destruir los valores originales en bytes. Conserva bytes para automatización y convierte únicamente en la capa que muestra los datos.

Get-PSDrive: consultar el proveedor de archivos

Get-PSDrive -PSProvider FileSystem
Get-PSDrive C | Select-Object Name, Root, Used, Free

Get-PSDrive describe las unidades de la sesión actual de PowerShell. Filtrar por FileSystem evita mezclar unidades de archivos con proveedores como registro, entorno, certificados o alias. También puede incluir ubicaciones mapeadas que sean relevantes para la sesión.

Usa Get-Volume cuando importen los detalles del volumen de Windows. Usa Get-PSDrive cuando la automatización ya trabaje con unidades de proveedores de PowerShell. Se superponen, pero no representan inventarios idénticos.

Cómo ver el espacio en disco en Linux

df de GNU informa el espacio disponible en sistemas de archivos montados:

df -h
df -h /var
df -h --output=source,fstype,size,used,avail,pcent,target
  • -h selecciona potencias legibles como KiB, MiB y GiB.
  • Pasar una ruta pide a df el sistema de archivos que contiene esa ruta.
  • --output selecciona columnas en GNU coreutils; no asumas que esta opción exclusiva de GNU existe en todo host similar a Unix.

Una fila típica identifica el origen, bloques totales, espacio usado, disponible, porcentaje y punto de montaje. Si un script analiza la salida, establece un locale conocido o utiliza una API estructurada cuando exista. El espaciado y los encabezados localizados son contratos frágiles.

Cómo ver el espacio en disco en macOS

macOS también ofrece df en Terminal:

df -h
df -h /
df -k /Users

La intención es la misma que en Linux, pero macOS incluye utilidades BSD y no GNU coreutils de forma predeterminada. No copies opciones específicas de GNU como --output en un script supuestamente portable sin detectar primero su compatibilidad.

Para una vista interactiva por categorías, macOS también muestra información de almacenamiento en Ajustes del Sistema. El desglose gráfico ayuda a una persona a decidir qué revisar; df es un mejor primitivo para automatización en terminal.

Por qué df y du no coinciden

df y du responden preguntas diferentes:

  • df pregunta al sistema de archivos cuánta capacidad está usada y disponible.
  • du recorre archivos y directorios para estimar su espacio asignado.

Pueden discrepar por archivos eliminados que continúan abiertos por un proceso, metadatos, snapshots, bloques reservados, enlaces duros, archivos dispersos, compresión, permisos y puntos de montaje ocultos bajo un directorio. Si falta capacidad, usa df para identificar el sistema afectado y luego du o una herramienta de búsqueda para investigar el contenido.

du -sh /var/log
du -h /var | sort -h | tail

Esos ejemplos son puntos de partida para diagnóstico, no comandos universales de limpieza. No elimines un archivo grande hasta comprender su propietario, política de retención, handles abiertos y ruta de recuperación.

Una consulta QZX en las plataformas compatibles

QZX expone el comando de solo lectura getDiskInfo:

qzx getDiskInfo --json
qzx getDiskInfo C: --json
qzx getDiskInfo /home --json

El catálogo documenta un argumento path. Sin él, el comando inspecciona los discos disponibles. Con una unidad de Windows o una ruta Unix, enfoca el destino correspondiente. El resultado estructurado incluye los campos comunes success y message, datos de discos y un resumen con total, usado, libre y porcentaje cuando están disponibles.

{
  "success": true,
  "message": "Disk information retrieved ...",
  "disks": [ ... ],
  "summary": {
    "total_space": 0,
    "used_space": 0,
    "free_space": 0,
    "percent_used": 0
  }
}

Es una ilustración de la forma, no una afirmación de que todos los sistemas compartan semántica idéntica. QZX normaliza la consulta y el contrato del resultado, pero conserva valores específicos de cada plataforma. No convierte letras en puntos de montaje ni elimina diferencias de cuotas, snapshots o espacio reservado.

Automatizar sin sorpresas

  1. Conserva los bytes originales. Usa GB o GiB redondeados para mostrar, no para calcular umbrales.
  2. Nombra la unidad. GB decimal y GiB binario no son iguales. Un número aislado es ambiguo.
  3. Identifica el sistema de archivos. Comprobar / no demuestra que /data o un volumen de contenedor tenga espacio.
  4. Maneja aparte volúmenes remotos y extraíbles. Pueden ser lentos, estar desconectados o depender de cuotas remotas.
  5. Registra cantidad y porcentaje. Diez gigabytes libres pueden ser cómodos en un volumen pequeño y urgentes en un servicio que crece rápido.
  6. Añade tendencia y contexto. Un umbral describe el estado; la velocidad de crecimiento ayuda a predecir cuándo actuar.
  7. No automatices la limpieza por defecto. Medir es solo lectura. Borrar exige otra política, destinos exactos, respaldo cuando corresponda y validación.

Si necesitas encontrar candidatos después de identificar un sistema limitado, QZX también documenta findLargeFiles. Separa descubrimiento y eliminación para que una herramienta informativa no se convierta en una limpieza sin revisión.

¿Comandos nativos o QZX?

Usa un comando nativo cuando el flujo apunte a una plataforma conocida y resulte valioso su modelo de objetos. Usa QZX cuando un agente con terminal o una automatización se beneficie de un nombre de comando, JSON explícito, contrato compartido success/message y vocabulario multiplataforma documentado.

Ninguna opción elimina la necesidad de probar en los sistemas reales compatibles. La explicación más amplia en nuestra guía de automatización multiplataforma cubre rutas, permisos, shells, codificaciones y diferencias de salida más allá del almacenamiento.

Preguntas frecuentes

¿Cómo veo el espacio en disco en Linux?

Ejecuta df -h para ver sistemas montados con capacidad, espacio usado, disponible y porcentaje en unidades legibles. Usa df -h /ruta para el sistema que contiene una ruta.

¿Cómo consulto el espacio en disco con PowerShell?

Get-Volume devuelve información de volúmenes de Windows. Get-PSDrive -PSProvider FileSystem muestra unidades de archivos de la sesión, incluidos Used y Free cuando están disponibles.

¿Cómo veo el espacio en disco en macOS?

En Terminal, df -h informa la capacidad montada en unidades legibles. La vista gráfica de almacenamiento de Ajustes del Sistema ofrece un resumen interactivo por categorías.

¿Qué diferencia hay entre df y du?

df informa capacidad y disponibilidad del sistema de archivos. du estima el espacio usado por archivos y directorios. Pueden diferir porque miden cosas distintas.

¿Cómo puede un agente de IA consultar espacio en distintos sistemas?

Puede elegir comandos nativos según el sistema o llamar qzx getDiskInfo --json para una operación compatible con datos estructurados y campos de resumen.

¿Poco espacio libre significa siempre lo mismo?

No. Bloques reservados, snapshots, cuotas, archivos dispersos o comprimidos, montajes, archivos borrados pero abiertos y la contabilidad de cada plataforma pueden cambiar el significado.

Fuentes primarias y lecturas adicionales