Dictado por voz en VS Code en un Mac

A diferencia de Slack, Notion o Gmail, VS Code tiene una función de dictado propia: Microsoft publica una extensión llamada VS Code Speech. Si conviene usarla depende de adónde vaya el texto.

Opción A: VS Code Speech (la extensión del fabricante)

1. Abre la vista de extensiones e instala VS Code Speech, publicada por Microsoft (ID de extensión ms-vscode.vscode-speech).
2. Coloca el cursor en el editor.
3. Pulsa Option+Command+V para ejecutar "Voice: Start Dictation in Editor". El mismo atajo lo detiene.
4. La extensión también habilita la entrada de voz en la vista de Chat, que es donde la usa la mayoría de la gente.

La limitación es el alcance. Dicta en VS Code y en ningún otro sitio, así que en cuanto cambias al navegador para escribir la descripción de la pull request, vuelves a una herramienta distinta y a un atajo distinto.

Opción B: Dictado de macOS (también funciona en el panel de terminal)

1. Activa el Dictado una sola vez: Ajustes del Sistema → Teclado → Dictado. Los pasos completos están en activar el dictado en macOS.
2. Haz clic en un comentario, un docstring, el cuadro del mensaje de commit de Source Control o la terminal integrada.
3. Inicia el Dictado, habla y luego detén el Dictado para finalizar.

El dictado del sistema llega a la terminal integrada y al cuadro del mensaje de commit del panel Source Control. Eso cubre los dos lugares a los que va realmente la mayor parte del texto dictado en un editor.

La trampa propia de VS Code: IntelliSense edita tu frase

VS Code muestra una lista de autocompletado mientras escribes, y por defecto un carácter separador de palabras puede aceptar la sugerencia resaltada. La prosa dictada es un flujo de palabras y separadores, así que un comentario puede acabar con el nombre de una variable del archivo en lugar de la palabra que dijiste. El síntoma es un comentario que se lee bien durante seis palabras y luego contiene algo como useEffectHandler en mitad de una frase.

• Establece "editor.acceptSuggestionOnCommitCharacter": false para que los separadores dejen de aceptar una sugerencia.
• Establece "editor.acceptSuggestionOnEnter": "off" para que un salto de línea hablado nunca elija una sugerencia.
• Establece "editor.quickSuggestions": { "comments": false, "strings": false } para que la lista nunca se abra en los lugares donde dictas.
• Dicta en el cuadro de commit de Source Control en lugar de en el editor cuando puedas. Es un campo de texto sencillo sin motor de autocompletado.

Qué merece la pena dictar en un editor

• Cuerpos de mensajes de commit, donde el porqué es prosa y el diff ya dice el qué.
• Docstrings y comentarios de funciones como primer borrador, que luego editas.
• Entradas de changelog y notas de versión.
• No código. Los identificadores, la densidad de signos de puntuación y las mayúsculas hacen que hablar sea más lento que el teclado.

Si no se escribe nada

• Ajustes del Sistema → Privacidad y seguridad → Micrófono → permite Visual Studio Code si usas la extensión VS Code Speech. El dictado del sistema, en cambio, lo captura macOS, por lo que necesita el permiso de la herramienta de dictado.
• El dictado no funciona en ninguna parte, no solo en VS Code: el dictado no funciona en el Mac.

Opción C: un solo atajo para el editor y el navegador

La mayor parte del texto que dicta un ingeniero no está en el editor. Está en la descripción de una pull request, en un ticket y en un hilo de Slack, por ese orden. Voice Type asigna un único atajo de mantener pulsado para dictar que funciona en todos ellos y ejecuta el modelo en tu Mac: dictado por voz para Mac.

Sigue leyendo

• Dictado en Cursor (por qué la extensión VS Code Speech no se instala allí)
• Dictar descripciones de pull requests en GitHub

Fuentes

• VS Code Docs: Voice support (the VS Code Speech extension)
• VS Code Docs: IntelliSense
• Apple: Dictate messages and documents on Mac