Post actualizado el día octubre 29, 2026 by DeiviSanzPlay
Cuando alguien intenta XAMPP configurar Mercurial Git por primera vez, casi siempre comete el mismo error: asume que los tres forman un ecosistema integrado y que basta con instalar XAMPP para que Mercurial y Git convivan sin más. No es así. XAMPP es un stack de servidor (Apache, MySQL, PHP, Perl) y no tiene ninguna relación nativa con el control de versiones. Mercurial y Git son herramientas independientes que se instalan aparte, con sus propios binarios, rutas y configuraciones. El fallo concreto: mezclar entornos y esperar que el panel de XAMPP gestione repositorios o detecte instalaciones de Mercurial/Git que no están en el PATH del sistema.
He visto a gente abrir el shell de XAMPP, escribir hg init y recibir un «comando no encontrado». El problema no es XAMPP, es que Mercurial no está instalado o no está en las variables de entorno. Lo mismo pasa con Git. El panel de control de XAMPP no incluye ni Mercurial ni Git, y no los va a incluir. Confundir el entorno de desarrollo web con el sistema de control de versiones es el origen de horas perdidas.
Por qué el shell de XAMPP no sustituye a Git Bash ni a la terminal del sistema
El shell de XAMPP es una ventana de comandos que hereda el PATH del sistema, pero no lo amplía. Si instalas Mercurial con el instalador oficial en Windows, normalmente añade la ruta al PATH, pero solo en sesiones nuevas. El shell de XAMPP abierto antes de la instalación seguirá sin verlo. Cerrar y reabrir el shell resuelve el 80% de los casos. En Linux o macOS, instalar Mercurial vía gestor de paquetes (apt, brew) sí lo deja disponible, pero XAMPP en esas plataformas es menos común y la gente suele usar el terminal del sistema, no el de XAMPP.
Con Git ocurre algo parecido. Git para Windows trae Git Bash, que es una terminal propia. Usar Git Bash para inicializar un repositorio dentro de htdocs de XAMPP funciona, pero no porque XAMPP lo gestione, sino porque Git Bash tiene su propio PATH y sus propias herramientas. El error es pensar que el panel de XAMPP muestra el estado del repositorio o permite hacer commits. No lo hace.
El lío de las rutas: htdocs no es un repositorio por defecto
Otro error frecuente al intentar XAMPP configurar Mercurial Git es inicializar el repositorio en la carpeta equivocada. La carpeta htdocs de XAMPP contiene todos los proyectos web. Si haces git init o hg init en la raíz de htdocs, acabas versionando todos los proyectos juntos, incluidos los archivos de configuración de XAMPP que no deberían estar bajo control de versiones. Lo correcto es crear un repositorio por proyecto, dentro de su propia carpeta, y añadir un .gitignore o .hgignore que excluya carpetas como logs, tmp o vendor si no quieres versionarlas.
En un caso real, un desarrollador inicializó Git en C:xampphtdocs y luego no entendía por qué cada cambio en un proyecto aparecía como modificación en otro. Había versionado la carpeta completa. La solución fue borrar el .git de la raíz y crear repositorios independientes en htdocs/miproyecto1 y htdocs/miproyecto2. Mercurial tiene el mismo problema: su .hg también se propaga a subcarpetas si no se aísla.
Mercurial y Git en el mismo proyecto: lo que no funciona
Tener Mercurial y Git controlando la misma carpeta de trabajo es una fuente de conflictos. No se sincronizan automáticamente y cada uno mantiene su propio historial. Si intentas usar ambos sobre el mismo directorio, acabarás con dos carpetas ocultas (.git y .hg) y dos estados distintos. Algunos equipos lo hacen para migrar de Mercurial a Git usando hg-git, una extensión que permite clonar y empujar entre ambos. Pero eso no es «configurar XAMPP», es configurar la extensión de Mercurial y requiere Python y dependencias adicionales. No es un botón en el panel de XAMPP.
Si tu objetivo es solo tener control de versiones local para un proyecto PHP servido por XAMPP, elige uno. Git es más popular y tiene mejor integración con editores como VS Code, que detecta el repositorio automáticamente al abrir la carpeta del proyecto. Mercurial es más sencillo en su curva de aprendizaje y su interfaz de línea de comandos es más consistente, pero el ecosistema de herramientas y servicios (GitHub, GitLab, Bitbucket) está volcado con Git. Elegir Mercurial hoy tiene sentido si vienes de un equipo que ya lo usa o si trabajas con repositorios grandes donde su rendimiento histórico era ventajoso, aunque esa ventaja se ha difuminado.
Variables de entorno y permisos: el detalle que rompe la configuración
En Windows, el error clásico es instalar Git o Mercurial sin marcar la opción de añadir al PATH. El instalador de Git pregunta explícitamente si quieres usar Git desde la línea de comandos y con qué terminal. Si eliges «Use Git from Git Bash only», el comando git no estará disponible en el shell de XAMPP ni en cmd. Mucha gente elige esa opción por miedo a romper algo y luego se pregunta por qué no funciona. La opción recomendada para trabajar con XAMPP es «Git from the command line and also from 3rd-party software», que añade Git al PATH del sistema.
Mercurial en Windows se instala con un ejecutable que también añade la ruta al PATH, pero a veces requiere reiniciar la sesión. En Linux, si instalas XAMPP como root y luego trabajas como usuario normal, los repositorios creados pueden tener permisos que impiden a Apache leer los archivos. Ese es un problema de permisos del sistema de archivos, no de Mercurial ni de Git, pero aparece justo después de configurar el control de versiones y se confunde con un fallo de la herramienta.
Comprobación rápida antes de seguir
Antes de tocar nada más, abre una terminal nueva y ejecuta git –version y hg –version. Si ambos responden, el PATH está bien. Si no, el problema es la instalación, no XAMPP. Después, entra en la carpeta de tu proyecto dentro de htdocs y ejecuta git init o hg init. Verás una carpeta oculta. A partir de ahí, el flujo es el habitual: git add, git commit o hg add, hg commit. XAMPP seguirá sirviendo la web igual; el control de versiones es una capa aparte que no afecta al servidor.
La conclusión es simple: XAMPP no configura Mercurial ni Git. Los instala el sistema operativo y los usa la terminal. Entender esa separación evita el error de principiante que consume más tiempo del necesario.
Perfiles verificables: Sitio web
Publicado el 29 de October de 2026. Última revisión: 29 de October de 2026.