pycharm三個有引號不能自動生成函數註釋的問題

2022-02-10 13:00:49

pycharm三個有引號不能自動生成函數註釋

函數註釋

自動生成函數註釋，包括引數和返回值。

使用方法，函數定義時，直接輸入三個雙引號後回車，例如：

    def add_script_flow(self, script_name, ip):
        """
        點選一個指令碼命令圖示，彈出引數設定框，選擇指令碼，輸入執行ip和
        :param script_name: 指令碼名稱
        :param ip: 執行ip
        :return:
        """

突然發現，不能自動生成註釋引數了

去File | Settings | Tools | Python Integrated Tools | Docstring format 這裡改成你想要的格式，然後再回去看看你的三個引號。沒有函數註釋的情況下是plain。改成reStucturedText。

Python的三引號的用法

python中三引號可以將複雜的字串進行復制

python三引號允許一個字串跨多行，字串中可以包含換行符、製表符以及其他特殊字元。
三引號的語法是一對連續的單引號或者雙引號（通常都是成對的用）。

跨多行、換行符、製表符

chat = """how are you?
i'm fine, than you,and you?
    me too!"""
print(chat)

加註釋

data = """name  # 姓名
age   # 年齡
sex   # 性別
"""
print(data)

多行註釋

Python中的註釋是用# ，但是#通常是單行註釋，在註釋有多行時，每一行多要寫一個# ，而用""""""卻可以一次性解決

"""
這是一個
多行註釋
註釋
"""
 
data = """name  # 姓名
age   # 年齡
sex   # 性別
"""
 
print(data)

sql語句：對於sql語句我們通常不建議用字串拼接，而使用引數，在表示式中沒有變數時，我們可以使用三引號來讓sql語句更清晰

import pymysql
try:
    # 建立連線
    db = pymysql.connect(host='localhost', user='root', passwd='root', db='scraping')
    # 建立遊標物件
    cur = db.cursor()
 
    # 新建表,三引號
    sql = """CREATE TABLE EMPLOYEE (
             FIRST_NAME  CHAR(20) NOT NULL,
             LAST_NAME  CHAR(20),
             AGE INT,
             SEX CHAR(1),
             INCOME FLOAT )"""
 
    cur.execute(sql)
 
finally:
    # 關閉資料庫連線
    cur.close()

還有插入資料

import pymysql
try:
    # 建立連線
    db = pymysql.connect(host='localhost', user='root', passwd='root', db='scraping')
    # 建立遊標物件
    cur = db.cursor()
    
    # SQL 插入語句
    sql = """INSERT INTO EMPLOYEE(FIRST_NAME,
             LAST_NAME, AGE, SEX, INCOME)
             VALUES ('Mac', 'Mohan', 20, 'M', 2000)"""
    try:
        # 執行sql語句
        cur.execute(sql)
        # 提交到資料庫執行
        db.commit()
    except:
        # 如果發生錯誤則回滾
        db.rollback()
 
finally:
    # 關閉資料庫連線
    cur.close()

如果使用單引號

import pymysql
try:
    # 建立連線
    db = pymysql.connect(host='localhost', user='root', passwd='root', db='scraping')
    # 建立遊標物件
    cur = db.cursor()
 
    # SQL 插入語句
    sql = "INSERT INTO EMPLOYEE(FIRST_NAME, 
           LAST_NAME, AGE, SEX, INCOME) 
           VALUES ('%s', '%s', '%d', '%c', '%d' )" % 
          ('Mac', 'Mohan', 20, 'M', 2000)
 
    try:
        # 執行sql語句
        cur.execute(sql)
        # 提交到資料庫執行
        db.commit()
    except:
        # 如果發生錯誤則回滾
        db.rollback()
 
finally:
    # 關閉資料庫連線
    cur.close()

以上為個人經驗，希望能給大家一個參考，也希望大家多多支援it145.com。