Descripción general
Google Style Guides para VSCode es un conjunto de scripts y configuraciones que implementan automáticamente las guías de estilo oficiales de Google en Visual Studio Code. Este proyecto facilita la configuración de linters y formateadores para múltiples lenguajes de programación.
¿Por qué usar Google Style Guides?
Las guías de estilo de Google establecen estándares reconocidos en la industria para escribir código limpio, legible y mantenible. Al seguir estas guías, aseguras que tu código sea consistente y siga buenas prácticas de programación.
Características principales
Multi-lenguaje
Compatible con JavaScript, TypeScript, Python, HTML/CSS, JSON, C++, Go, Java, Markdown y Shell.
Instalación automatizada
Scripts que configuran VSCode y todas las herramientas necesarias con un solo comando.
Adaptativo
Soluciona automáticamente problemas como entornos Python gestionados externamente.
Documentado
Instrucciones detalladas, ejemplos y solución de problemas para cada configuración.
Instalación
Instalación completa
Para configurar todas las guías de estilo:
# Clonar el repositorio
git clone https://github.com/leonvallejoss/google-style-guides-vscode.git
cd google-style-guides-vscode
# Ejecutar el script principal
chmod +x vscode-google-style-config.sh
./vscode-google-style-config.shSolo YAPF para Python
Si necesitas configurar específicamente YAPF para entornos Python gestionados externamente:
chmod +x install-yapf.sh
./install-yapf.shGuías de estilo implementadas
Resolución de problemas comunes
Error "externally-managed-environment" en Python
Este error ocurre en sistemas con Python gestionado externamente (como macOS recientes).
Solución: Usa nuestro script install-yapf.sh que crea un entorno virtual para YAPF.
Problemas de permisos
Si encuentras errores "Permission denied" al ejecutar los scripts:
sudo chmod -R 755 google-style-guides-vscode
cd google-style-guides-vscode
sudo chmod +x *.sh