Kurzübersicht
1. Kodierung
Wenn keine besonderen Umstände vorliegen , die Datei verwendet immer UTF-8 Codierung
Sofern keine besonderen Umstände vorliegen, Der Dateikopf muss mit dem #-*-coding:utf-8-*-mark
2 Codeformat
< hinzugefügt werden 🎜>2.1 , Einzug
- einheitlich verwenden 4 Mit Leerzeichen einrücken
2.2. Zeilenbreite
Jede Codezeile sollte 80 Zeichen nicht überschreiten (bei Sonderzeichen kann es etwas mehr sein). Umstände) 80, aber das Maximum 120)
Grund:
- Dies ist ein Vergleichsvergleich Sehr hilfreich
- Praktisch, um den Code unter der Konsole anzuzeigen
- Zu lang kann ein Designfehler sein
2.3. Anführungszeichen
Einfach ausgedrückt verwendet die natürliche Sprache doppelte Anführungszeichen und die maschinelle Markierung verwendet einfache Anführungszeichen
Im Code sollten die meisten einfache Anführungszeichen verwenden
- Natürliche Sprache verwendet doppelte Anführungszeichen „..."
Beispielsweise Fehlermeldungen; Unicode, verwenden Sie u"Hello World"
- Die Maschinenkennung verwendet einfache Anführungszeichen '...'. Zum Beispiel der Schlüssel in dict
- Regulärer Ausdruck Die Formel verwendet native doppelte Anführungszeichen r"..."
- docstring (docstring) Verwenden Sie drei doppelte Anführungszeichen """......"""
2.4, Leerzeile
- Modul Zwei Leerzeilen zwischen Funktionen auf Blockebene und Klassendefinitionen; eine Leerzeile zwischen
- Klassenmitgliedsfunktionen
class A:
def __init__(self):
pass
def hello(self):
pass
def main():
pass
- Sie können mehrere Leerzeilen verwenden, um mehrere Gruppen verwandter Funktionen zu trennen
- Sie können Leerzeilen in Funktionen verwenden Trennen Sie logisch verwandte Codes
2.5, Codierung
- Dateinutzung UTF-8-Kodierung
- #-*-conding:utf-8-*-logo zum Dateikopf hinzufügen
3 . Import-Anweisung
import Anweisungen sollten in separaten Zeilen geschrieben werden
# 正确的写法
import os
import sys
# 不推荐的写法
import sys,os
# 正确的写法
from subprocess import Popen, PIPE
import语句应该使用 absolute import
# 正确的写法
from foo.bar import Bar
# 不推荐的写法
from ..bar import Bar
- Die Importanweisung sollte am Anfang der Datei, nach der Modulbeschreibung und der Dokumentzeichenfolge sowie in der globalen Variablen platziert werden vorher;
- Importanweisungen sollten der Reihe nach angeordnet werden, wobei jede Gruppe durch eine Leerzeile getrennt werden sollte
import os
import sys
import msgpack
import zmq
import foo
- Beim Importieren von Klassendefinitionen aus anderen Modulen können Sie relative Importe verwenden
from myclass import MyClass
- Wenn ein Namenskonflikt auftritt, können Sie Namespaces verwenden
import bar
import foo.bar
bar.Bar()
foo.bar.Bar()
4. Leerzeichen
- Ein Leerzeichen auf jeder Seite des binären Operators [=,-, =,==, > ;,in,is nicht, und]:
# 正确的写法
i = i + 1
submitted += 1
x = x * 2 - 1
hypot2 = x * x + y * y
c = (a + b) * (a - b)
# 不推荐的写法
i=i+1
submitted +=1
x = x*2 - 1
hypot2 = x*x + y*y
c = (a+b) * (a-b)
- In der Parameterliste der Funktion muss danach ein Leerzeichen
stehen
# 正确的写法
def complex(real, imag):
pass
# 不推荐的写法
def complex(real,imag):
pass
# 正确的写法
def complex(real, imag=0.0):
pass
# 不推荐的写法
def complex(real, imag = 0.0):
pass
# 正确的写法
spam(ham[1], {eggs: 2})
# 不推荐的写法
spam( ham[1], { eggs : 2 } )# 正确的写法
dict['key'] = list[index]
# 不推荐的写法
dict ['key'] = list [index]
# 正确的写法
x = 1
y = 2
long_variable = 3
# 不推荐的写法
x = 1
y = 2
long_variable = 3
5. Zeilenumbrüche
Python Unterstützt Zeilenumbrüche in Klammern. Derzeit gibt es zwei Situationen.
1. Die zweite Zeile wird zum Anfang der Klammer eingerückt
foo = long_function_name(var_one, var_two,
var_three, var_four)
2. Die zweite Zeile wird um 4 Leerzeichen eingerückt, was für den Fall geeignet ist, dass die Startklammer neu ist Zeile
def long_function_name(
var_one, var_two, var_three,
var_four):
print(var_one)
Verwenden Sie Backslash für Zeilenumbrüche, binären Operator .etc. sollte am Ende der Zeile stehen; lange Zeichenfolgen können mit dieser Methode auch umgebrochen werden
session.query(MyTable).\
filter_by(id=1).\
one()
print 'Hello, '\
'%s %s!' %\
('Harry', 'Potter') Zusammengesetzte Anweisungen sind verboten, das heißt, eine Zeile enthält mehrere Anweisungen:
# 正确的写法
do_first()
do_second()
do_third()
# 不推荐的写法
do_first();do_second();do_third();
if/for/while muss zeilenweise umbrochen werden:
# 正确的写法
if foo == 'blah':
do_blah_thing()
# 不推荐的写法
if foo == 'blah': do_blash_thing()
6.docstring
docstring Die zwei grundlegendsten Punkte in der Spezifikation:
1. Alle öffentlichen Module, Funktionen, Klassen und Methoden sollten in Docstring geschrieben werden. Private Methoden sind nicht unbedingt erforderlich, sollten aber mit einem Blockkommentar nach der Def versehen werden.
2. Das Ende des Dokumentstrings „“ sollte in einer eigenen Zeile stehen, es sei denn, der Dokumentstring hat nur eine Zeile.
rrree
nächsten Abschnitt