7.2 KiB
Preguntas frecuentes (FAQ)
¿Cuál es la configuración usada en el GIF de demostración?
- Emulador de terminal: iTerm2
- Tema: Mínimo
- Esquema de color: Snazzy
- Font: FiraCode Nerd Font
- Intérprete de comandos: Fish Shell
- Configuración: archivos de configuración de matchai
- Prompt: Starship
¿Cómo obtengo el autocompletado del comando como se muestra en el GIF?
El soporte de terminación, o autocompletado, es proporcionado por tu intérprete de comandos de elección. En el caso de la demo, la demo se realizó con Fish Shell, que proporciona el completado por defecto. Si usas Z Shell (zsh), te sugerimos echar un vistazo a zsh-autosuggeries,.
¿prompt_order y <module>.disabled hacen lo mismo?
Sí, se pueden usar ambos para desactivar los módulos en el prompt. Si todo lo que planeas es desactivar módulos, <module>.disabled es el método preferido por las siguientes razones:
- Deshabilitar módulos es más explícito que omitirlos del nivel superior
format - Los nuevos módulos se añadirán al prompt en cuanto Starship se actualice
La documentación dice que Starship es "cross-shell". ¿Por qué no es compatible mi intérprete de comandos preferido?
Por la forma en que Starship está construído, debería ser posible añadir soporte para prácticamente cualquier intérprete de comandos. El binario de Starship es sin estado y agnóstico, por lo que mientras que tu intérprete de comandos se pueda ampliar y soporte la personalización del prompt, puedes utilizar Starship.
Aquí tienes un pequeño ejemplo haciendo que Starship funcione con bash:
# Obtener el código de estado del último comando ejecutado
STATUS=$?
# Calcula el número de tareas ejecutándose.
NUM_JOBS=$(jobs -p | wc -l)
# Establece el prompt a la salida de `starship prompt`
PS1="$(starship prompt --status=$STATUS --jobs=$NUM_JOBS)"
La implementación de Bash integrada en Starship es un poco más compleja para permitir funciones avanzadas como el módulo Duración del Comando y para garantizar que Starship sea compatible con las configuraciones de Bash preinstaladas.
Para obtener una lista de todos los parámetros aceptados por el prompt de Starship, usa el siguiente comando:
starship prompt --help
El símbolo de sistema usará tanto contexto como le proveas, pero no hay parámetros "obligatorios".
¿Cómo lanzo Starship en distribuciones Linux con versiones antiguas de glibc?
Si obtienes un error como "version 'GLIBC_2.18' not found (required by starship)" al usar el binario precompilado (por ejemplo, en CentOS 6 o 7), puedes usar el binario compilado con musl en vez de glibc:
sh -c "$(curl -fsSL https://starship.rs/install.sh)" -- --platform unknown-linux-musl
Why do I see Executing command "..." timed out. warnings?
Starship executes different commands to get information to display in the prompt, for example the version of a program or the current git status. To make sure starship doesn't hang while trying to execute these commands we set a time limit, if a command takes longer than this limit starship will stop the execution of the command and output the above warning, this is expected behaviour. This time limit is configurable using the command_timeoutkey so if you want you can increase the time limit. You can also follow the debugging steps below to see which command is being slow and see if you can optimise it. Finally you can set the STARSHIP_LOG env var to error to hide these warnings.
Veo símbolos que no entiendo ni espero, ¿qué significan?
Si ves símbolos que no reconoces, puedes usar starship explain para explicar los módulos que se muestran actualmente.
Starship is doing something unexpected, how can I debug it?
You can enable the debug logs by using the STARSHIP_LOG env var. These logs can be very verbose so it is often useful to use the module command if you are trying to debug a particular module, for example, if you are trying to debug the rust module you could run the following command to get the trace logs and output from the module.
env STARSHIP_LOG=trace starship module rust
If starship is being slow you can try using the timings command to see if there is a particular module or command that to blame.
env STARSHIP_LOG=trace starship timings
This will output the trace log and a breakdown of all modules that either took more than 1ms to execute or produced some output.
Finally if you find a bug you can use the bug-report command to create a Github issue.
reporte de error starship
¿Por qué no veo un símbolo de glifo en mi prompt?
La causa más común de esto es la mala configuración del sistema. Algunas distribuciones de Linux en particular no vienen con soporte de fuentes listos para usarse. Tienes que garantizar que:
- Tu configuración regional está establecida con un valor UTF-8, como
de_DE.UTF-8oja_JP.UTF-8. SiLC_ALLno es un valor UTF-8, necesitarás cambiarlo. - Tienes una fuente emoji instalada. La mayoría de los sistemas vienen con una fuente emoji por defecto, pero algunos (notablemente Arch Linux) no. Generalmente puedes instalar uno a través del gestor de paquetes del sistema --noto emoji es una elección popular.
- Estás usando un Nerd Font.
Para probar tu sistema, ejecua los siguientes comandos en un terminal:
echo -e "\xf0\x9f\x90\x8d"
echo -e "\xee\x82\xa0"
La primera línea debe producir un emoji snake, mientras que la segunda debe producir un símbolo de rama de Powerline(e0a0).
Si cualquiera de los dos símbolos no se puede mostrar correctamente, su sistema todavía está mal configurado. Desafortunadamente, obtener la configuración correcta de las fuentes es a veces difícil. Los usuarios en el Discord pueden ayudar. Si ambos símbolos se muestran correctamente, pero todavía no los ves en Starship, ¡envía un informe de error!
¿Cómo puedo desinstalar Starship?
Starship es tan fácil de desinstalar como de instalar en primer lugar.
- Elimina cualquier línea de tu configuración de intérprete de comandos (por ejemplo,
~/.bashrc) usada para inicializar Starship. - Elimina el binario de Starship.
Si Starship fue instalado usando un gestor de paquetes, por favor refiérete a sus documentos para instrucciones de desinstalación.
Si Starship fue instalado usando el guión de instalación, el siguiente comando eliminará el binario:
# Locate and delete the starship binary
sh -c 'rm "$(command -v 'starship')"'