El comando basename extrae el último componente de una ruta: por ejemplo, convierte /var/log/nginx/access.log en access.log. Es útil para mostrar nombres de archivo en scripts o para separar un nombre de su directorio. Trabaja con la cadena que recibe; no comprueba que el archivo exista ni resuelve enlaces simbólicos o rutas relativas.
En esta guía verás la sintaxis portable, las opciones habituales de GNU Coreutils y un ejemplo Bash que conserva espacios en los nombres. Para ampliar el aprendizaje, consulta la guía de comandos Linux y el curso de Linux gratis.
Sintaxis básica
basename NOMBRE [SUFIJO]
basename OPCIÓN NOMBRE...NOMBRE es una ruta absoluta o relativa. SUFIJO es una cadena opcional que se elimina solo si coincide exactamente con el final del componente obtenido. La segunda forma resume las extensiones de GNU Coreutils; las opciones GNU no están disponibles en todos los sistemas Unix.
basename /var/log/nginx/access.log
basename /var/log/nginx/access.log .logEl primer comando muestra access.log; el segundo muestra access. El sufijo no se interpreta como una extensión especial: se quita la cadena indicada si aparece al final. Por eso puedes retirar, por ejemplo, .tar.gz completo al indicarlo como sufijo.
Opciones comunes de GNU basename
| Opción | Qué hace | Cuándo usarla |
|---|---|---|
| -a | Procesa varios nombres en una sola ejecución. | Cuando el script ya tiene varias rutas. Es una opción de GNU. |
| -s SUFIJO | Quita el sufijo indicado de cada nombre; habilita el procesamiento múltiple. | Para quitar la misma terminación a varios nombres. Es una opción de GNU. |
| -z | Termina cada salida con un byte NUL en lugar de un salto de línea. | Para pasar nombres que pueden contener saltos de línea a otra herramienta compatible. No lee una lista NUL de la entrada. |
La opción -z cambia el separador de salida; no hace que basename lea nombres desde un archivo. En Unix los nombres pueden contener saltos de línea, por lo que el formato NUL evita confundir un nombre con varios registros. El byte NUL no puede formar parte de un nombre de archivo.
Ejemplo práctico en Bash
El siguiente ejemplo usa una matriz de Bash para guardar las rutas como elementos separados. Las comillas de la expansión preservan los espacios, y el marcador de fin de opciones indica que los argumentos siguientes son nombres aunque alguno empiece por un guion. Las opciones mostradas son de GNU Coreutils.
#!/usr/bin/env bash
rutas=(
"/home/ana/Informe final.txt"
"/var/log/nginx/access.log"
"config/app.yaml"
)
printf 'Componente final:\n'
basename -a -- "${rutas[@]}"
printf '\nSin el sufijo .txt cuando aparece:\n'
basename -s .txt -- "${rutas[@]}"La primera llamada imprime los nombres de las tres rutas: Informe final.txt, access.log y app.yaml. La segunda elimina .txt cuando ese sufijo aparece al final; los otros nombres quedan igual. -s ya activa el procesamiento múltiple, por lo que no hace falta añadir también -a.
Límites y errores frecuentes
- No normaliza la ruta: no convierte .. en su destino real, no elimina enlaces simbólicos ni confirma que el archivo exista. Para resolver una ruta, se necesita otra herramienta.
- El sufijo debe coincidir: si el componente no termina exactamente con la cadena indicada, basename lo deja intacto.
- Protege espacios y guiones: entre comillas, cada ruta llega como un solo argumento; con GNU basename, el marcador de fin de opciones evita que una ruta que empieza por guion se interprete como opción.
- Usa NUL en flujos sensibles: si un nombre puede contener saltos de línea y otra herramienta lo procesará, el formato de salida NUL de -z es más seguro que separar por líneas.
La forma básica con un nombre y un sufijo está estandarizada por POSIX. Las opciones -a, -s, -z y el marcador de fin de opciones son extensiones habituales de GNU; revisa la ayuda de la implementación instalada si el script debe ejecutarse en otros Unix.
Demostración en video
En este video puedes ver el uso de basename para extraer nombres de rutas en Linux.

