Dicas para comentários de programação, espaço em branco, e recuo em seu BeagleBone

Não há tal coisa como um método perfeito de programação. programadores avançados costumam desenvolver seu próprio estilo. Definitivamente, existem normas para escrever um código melhor, no entanto. Se você está trabalhando com uma equipe, contribuindo para um projeto de código aberto, o desenvolvimento de um programa que vai demorar vários dias ou semanas para ser concluído, ou escrever algo que você pode olhar novamente um par de meses mais tarde, você deve sempre fazer o Segue:

  • Comentar seu código. Digitando comentários descritivos requer apenas um ligeiro esforço de escrita que pode fazer uma enorme diferença no longo prazo. Com os comentários apropriados, você nunca precisa descobrir o que é um trecho de código faz. A explicação é logo ali!

  • Use o espaço em branco. Adicionando espaços extras entre seus nomes e funções variáveis, bem como as linhas entre as instruções, torna seu código mais bonito e mais legível. A maioria das linguagens de programação ignorar o espaço em branco extra, então não há absolutamente nenhum problema em usá-lo para promover a legibilidade.

    Por exemplo, você pode usar o espaço em branco para a organização sob a forma de linhas extras entre instruções para criar blocos de código semelhante, como neste exemplo:

    Adafruit_BBIO.PWM importação como PWM # Import objetos de librariesimport Adafruit_BBIO.ADC como ADCimport Adafruit_BBIO.UART como UARTimport matemática #import librariesimport timeimport serialled = "P9_16" variáveis ​​#define para pinssensor = "P9_40" PWM.start (levou, 0) #initialize modulesADC.setup () UART.setup ( "UART1")
  • Recuar seu código. forças Python você a usar o recuo, mas muitas linguagens de programação não. Acreditem em nós quando dizemos que ser preguiçoso na sua programação e não se preocupar com recuo pode levar a um monte de frustração se um erro ocorre. O bug pode ser simplesmente uma cinta mais ou faltando fechamento (}), que é fácil de detectar se o seu código é recuado - e uma dor de encontrar se não é.

A origem do termo erro vem de um bug literal no sistema. O termo foi usado pela primeira vez em ciência da computação em 1946, quando o pioneiro da computação Grace Hopper revelou que a causa de uma avaria em um computador eletromecânico início era uma mariposa presa em um relé.

menu