Contador de comentarios de código
Mida cuánto de un archivo de código explica en lugar de ejecutar: un fragmento de seis líneas con tres de comentario y tres de código da una proporción de 1 y un 50 % de comentarios. Los marcadores dentro de comillas no cuentan. Gratis en su navegador.
- Gratis
- Funciona en su navegador
- Sin registro
- Sus datos no salen de su equipo
Ejecutar — gratis
Ejemplo resuelto
- Idioma
- Javascript
- Total de líneas
- 6
- Líneas en blanco
- 1
- Líneas de comentario
- 3
- Líneas de código
- 3
El contador de líneas de comentarios mide qué parte de un archivo fuente se dedica a explicaciones y qué parte a código ejecutable. Pegue el código, seleccione el lenguaje o use la detección automática y obtenga los totales de comentarios, código, líneas vacías y mixtas, además de la proporción entre comentarios y código. Es un indicador compacto de densidad documental para revisiones, planificación del mantenimiento, paneles de calidad y auditorías de repositorios. El análisis léxico es determinista, evita contar marcadores dentro de cadenas y siempre muestra el lenguaje elegido.
Interprete la métrica sin convertirla en un objetivo
La densidad de comentarios resulta útil cuando inicia una conversación, no cuando se convierte en una puntuación universal. Este contador divide las líneas con comentarios entre las líneas con código y también expresa los comentarios como porcentaje del conjunto observado. Una línea que contiene código y un comentario final pertenece a ambas categorías; el total separado de líneas mixtas hace visible ese solapamiento.
Las líneas vacías no pertenecen a ninguna. Estas definiciones permiten comparar mediciones repetidas, pero no implican que más comentarios produzcan siempre mejor software. Una función pequeña puede explicarse bien mediante nombres y pruebas, mientras que un protocolo quizá necesite notas extensas sobre invariantes y restricciones externas.
Compare archivos de función, lenguaje y madurez similares. Busque cambios llamativos: explicaciones eliminadas de un subsistema complejo, cabeceras engañosas en código generado o un aumento causado por código desactivado dentro de comentarios. Combine el resultado con complejidad, cobertura, frecuencia de cambios y criterio profesional.
La métrica señala dónde leer; no determina si un comentario es correcto, necesario o útil.
Seleccione el lenguaje y conozca las reglas de conteo
Seleccione el lenguaje fuente cuando lo conozca, porque los delimitadores de comentarios varían. Los lenguajes de la familia C usan comentarios de línea con doble barra y bloques entre barra-asterisco; Python y los scripts de shell usan almohadilla; SQL combina doble guion con bloques, y HTML emplea delimitadores de marcado. El modo automático examina patrones comunes y devuelve el lenguaje inferido, de modo que la decisión nunca queda oculta.
El analizador sigue comentarios de bloque entre varias líneas e ignora supuestos delimitadores dentro de cadenas con comillas simples, dobles o invertidas. Clasifica cada línea física según contenga código, comentario, ambos o ninguno. Por ello, cada línea ocupada por un bloque multilínea suma como comentario.
Un comentario al final de una instrucción incrementa código, comentarios y líneas mixtas. Este método léxico es determinista y rápido, pero no es un compilador completo. Cadenas sin procesar exóticas, lenguajes incrustados, trucos del preprocesador y literales de documentación pueden requerir una selección explícita o un analizador especializado cuando la clasificación semántica exacta sea imprescindible.
Use el resultado en revisiones y controles de mantenimiento
En una revisión individual, ejecute el contador antes y después del cambio y examine variaciones grandes en vez de imponer un umbral fijo. Una proporción menor en un algoritmo que acaba de ganar complejidad puede indicar que faltan explicaciones sobre supuestos o casos límite. Una proporción mayor puede reflejar documentación saludable, pero también código comentado que convendría eliminar y conservar mediante el control de versiones.
Para analizar un repositorio, guarde los totales junto con el identificador del commit, lenguaje, ruta y condición de archivo generado. Agregue únicamente grupos comparables: configuración, pruebas, clientes generados y lógica de aplicación tienen necesidades documentales distintas. Utilice la cifra como evidencia para priorizar: combínela con la frecuencia de cambios para hallar archivos muy editados y poco explicados, o con la complejidad para dirigir la atención de quienes revisan.
Lea siempre los comentarios reales antes de concluir algo sobre mantenibilidad.
Qué puede hacer con ella
Revisar cambios de documentación
Compare la densidad antes y después de un cambio e investigue variaciones inesperadas en archivos complejos.
Crear un panel de calidad
Registre conteos y proporciones estables junto con complejidad, cambios y cobertura de pruebas.
Priorizar el mantenimiento
Localice módulos modificados con frecuencia que ofrecen muy poco contexto explicativo.
Preguntas frecuentes
¿Qué es la proporción entre comentarios y código?
Es el número de líneas con comentarios dividido entre el número de líneas con código, redondeado a seis decimales.
¿Cómo se cuentan las líneas con código y comentarios?
Cuentan una vez como código, otra como comentario y otra en el campo separado de líneas mixtas.
¿Las líneas vacías afectan a la proporción?
No. Se presentan por separado y quedan fuera de ambos términos de la proporción.
¿Qué ocurre si un archivo contiene comentarios pero no código?
El campo de proporción se omite porque la división entre cero no tiene resultado finito; los conteos individuales permanecen disponibles.
¿La detección automática del lenguaje es exacta?
No. Usa reglas conservadoras basadas en patrones y muestra su elección. Seleccione el lenguaje explícitamente cuando la precisión sea esencial.
¿La herramienta evalúa la calidad de los comentarios?
No. Mide la densidad de líneas físicas, no si los comentarios son correctos, actuales o útiles.
Herramientas relacionadas
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/dev/count-comments \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"// Convert a value\nfunction double(value) {\n return value * 2; // arithmetic\n}"}'const res = await fetch("https://api.kit.forhosting.com/dev/count-comments", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"text": "// Convert a value\nfunction double(value) {\n return value * 2; // arithmetic\n}"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/dev/count-comments",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"text": "// Convert a value\nfunction double(value) {\n return value * 2; // arithmetic\n}"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev/count-comments", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"text":"// Convert a value\\nfunction double(value) {\\n return value * 2; // arithmetic\\n}"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"text":"// Convert a value\nfunction double(value) {\n return value * 2; // arithmetic\n}"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev/count-comments", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"text": "// Convert a value\nfunction double(value) {\n return value * 2; // arithmetic\n}"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "dev.count_comments",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Límites
max_mb | 5 |
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |
Notas técnicas
Use el resultado en revisiones y controles de mantenimiento
La salida JSON estable encaja en paneles de calidad e informes de integración continua, mientras el ejecutor del navegador permite comprobaciones rápidas y privadas. La automatización mediante API cuesta $0.002 por solicitud.