Agregar comentarios al código

Cuando escriba código, se recomienda agregar comentarios que lo describan. Los comentarios permiten que otros comprendan el código y, además, pueden refrescar su memoria cuando vuelva a examinarlo más tarde. Durante el desarrollo y las pruebas de código, también puede utilizar los comentarios para agregar un comentario en el código que no sea necesario ejecutar.

En Live Editor, puede insertar líneas de texto antes y después del código para describir un proceso o código. Las líneas de texto ofrecen mayor flexibilidad, como opciones de formato estándar y la inserción de imágenes, hipervínculos y ecuaciones. Para obtener más información, consulte Crear scripts en vivo en Live Editor.

Agregar comentarios

Para agregar comentarios en el código de MATLAB®, use el símbolo de porcentaje (%). Las líneas de comentarios pueden aparecer en cualquier parte de un archivo de código, y se pueden añadir comentarios al final de una línea de código.

Por ejemplo:

% Add up all the vector elements.
y = sum(x)           % Use the sum function.

Agregar comentarios en el código

Para agregar un comentario en varias líneas de código, utilice los operadores de comentario en bloque, %{ y %}. Los operadores %{ y %} deben aparecer solos en las líneas que les preceden inmediatamente y seguir al bloque del texto de ayuda. No incluya ningún otro texto en estas líneas.

Por ejemplo:

a = magic(3);
%{
sum(a)
diag(a)
sum(diag(a))
%}
sum(diag(fliplr(a)))

Para agregar un comentario en una selección, seleccione las líneas de código, vaya a la pestaña Editor o Live Editor, y en la sección Code, haga clic en el botón de comentario . También puede pulsar Ctrl+R. Para eliminar el comentario de las líneas de código seleccionadas, haga clic en el botón de eliminar el comentario o haga clic en Ctrl+Mayús.+R. En sistemas macOS, utilice Comando+/ para comentar y Comando+Opción+/ para eliminar el comentario. En sistemas Linux®, utilice Ctrl+/ para comentar y Ctrl+Mayús.+/ para eliminar el comentario.

Para agregar un comentario en parte de una instrucción que abarca varias líneas, utilice el signo de puntos suspensivos (...) en lugar del signo de porcentaje. Por ejemplo:

header = ['Last Name, ',      ...
          'First Name, ',     ...
      ... 'Middle Initial, ', ...
          'Title']

Reajustar comentarios

De forma predeterminada, al escribir comentarios en el editor y en Live Editor, el texto se reajusta cuando alcanza un ancho de columna de 75. El editor y Live Editor no reajustan los comentarios en:

  • Títulos de las secciones (los comentarios que comienzan por %%)

  • Texto contiguo largo, como las URL

  • Elementos de listas con viñetas (el texto que comienza por * o #) en la línea anterior

Para cambiar el lugar en el que se reajusta el texto de los comentarios o desactivar el reajuste automático de los comentarios, vaya a la pestaña Home y, en la sección Environment, haga clic en Settings. Seleccione MATLAB > Editor/Debugger > MATLAB Language y ajuste la configuración de Comment formatting.

Antes de R2025a: Seleccione MATLAB > Editor/Debugger > Language en su lugar.

Si tiene comentarios existentes que sobrepasan el ancho actual de la columna, para reajustar automáticamente el comentario, vaya a la pestaña Editor o Live Editor y, en la sección Code, haga clic en el botón de reajustar los comentarios . Por ejemplo, suponga que tiene este texto largo en una línea comentada.

% This is a code file that has a comment that is a little more than 75 columns wide.
disp('Hello, world')
Con el cursor en la línea, vaya a la pestaña Editor o Live Editor, y en la sección Code, haga clic en el botón de reajustar los comentarios . El comentario se reajusta en la siguiente línea:
% This is a code file that has a comment that is a little more than 75
% columns wide.
disp('Hello, world')

Verificar ortografía en comentarios

Desde R2024a

Puede comprobar si existen errores ortográficos en los comentarios. Las palabras con un posible error ortográfico se subrayan en azul. Para resolver el error, haga clic en la palabra y seleccione una de las correcciones sugeridas. También puede elegir ignorar el error o añadir la palabra señalada al diccionario local. Para desplazarse de un error a otro con el teclado, use Alt+F7 y Alt+Shift+F7.

La comprobación de la ortografía admite inglés de Estados Unidos para archivos de código de MATLAB (.m), archivos de código en vivo (.m y .mlx) y archivos Markdown. Para eliminar palabras del diccionario local, vaya a la carpeta de configuración de MATLAB (la carpeta devuelta cuando ejecuta prefdir) y edite el archivo dict/en_US_userDictionary.tdi.

De forma predeterminada, la comprobación de la ortografía está activada. Si un archivo contiene muchas palabras no reconocidas, como cuando no están escritas en inglés de Estados Unidos, MATLAB desactiva automáticamente la comprobación de la ortografía de ese archivo. Para desactivar manualmente la comprobación de la ortografía de un archivo, vaya a la pestaña View y, en la sección Review, desactive el botón Spelling. Para desactivar la comprobación de la ortografía de forma predeterminada en todos los archivos, en la pestaña Home, en la sección Environment, haga clic en Settings. Seleccione MATLAB > Editor/Debugger > Spelling y establezca Check spelling en Off. Para cambiar el texto cuya ortografía se desea comprobar, en la sección Where to check spelling, seleccione o desactive las opciones disponibles. Para obtener más información, consulte Editor/Debugger Spelling Settings.

Antes de R2026a: De forma predeterminada, la comprobación de la ortografía está desactivada. Para activar la comprobación de la ortografía, vaya a la pestaña View y, en la sección Review, active el botón Spelling. Además, la configuración de la ortografía no está disponible y la comprobación de ortografía no se admite en archivos Markdown.

Consulte también

Temas

Recursos de formación