撰寫 Python 發送成績給學生確認

程式功能概述

此 Python 程式使用 smtplib 庫來自動發送學生成績通知郵件。從 Excel 檔案中讀取每位學生的成績，並依據其學號生成專屬郵件，郵件以純文字格式發送至指定學校郵箱地址。為了避免 Gmail 將郵件自動摺疊，程式為每封郵件添加了唯一的時間標記。

步驟詳解

1. 準備所需的程式庫

我們使用以下程式庫：

pandas：讀取 Excel 檔案，將學生的成績資料導入程式。
smtplib：用於設定 SMTP 伺服器並發送郵件。
datetime：生成唯一的時間標記，避免 Gmail 認定郵件內容相同。

1
import pandas as pd
2
import smtplib
3
from email.mime.text import MIMEText
4
from email.mime.multipart import MIMEMultipart
5
from datetime import datetime

2. 讀取 Excel 檔案

使用 pandas 讀取 Excel 檔案的「工作表 1」工作表。只提取所需的欄位：班級、學號、姓名、隨堂1 至 隨堂4。

1
file_path = 'ta-score-mid.xlsx'
2
data = pd.read_excel(file_path, sheet_name='工作表1')
3
data = data[['班級', '學號', '姓名', '隨堂1', '隨堂2', '隨堂3', '隨堂4']]

3. 設定 SMTP 伺服器

在此程式中，我們使用 Gmail 的 SMTP 伺服器來發送郵件。設定伺服器地址、登入帳號和應用程式密碼。

1
smtp_server = "smtp.gmail.com"
2
smtp_port = 587
3
smtp_user = "your_email@gmail.com"  # 替換為您的 Gmail 地址
4
smtp_password = "your_app_specific_password"  # 替換為您的應用程式密碼

4. 開啟伺服器連接

使用 smtplib.SMTP 建立伺服器連接，啟動 TLS 安全層後登入帳號。

1
server = smtplib.SMTP(smtp_server, smtp_port)
2
server.starttls()
3
server.login(smtp_user, smtp_password)

5. 構建並發送郵件

對每位學生資料迴圈處理：

生成個性化的郵件主體，包含學生成績資訊。
將「學號」欄位轉為小寫格式，以符合學校郵箱格式。
添加當前時間作為唯一標記，避免 Gmail 摺疊郵件。

1
for index, row in data.iterrows():
2
    student_id = row['學號'].lower()
3
    student_name_full = row['姓名']
4
    student_name = student_name_full[-2:]
5
    email_to = f"{student_id}@stust.edu.tw, {student_id}@office.stust.edu.tw"
6
    subject = "基礎數學 期中作業成績確認"
7

8
    scores = (
9
        f"隨堂1: {row['隨堂1']}\\n"
10
        f"隨堂2: {row['隨堂2']}\\n"
11
        f"隨堂3: {row['隨堂3']}\\n"
12
        f"隨堂4: {row['隨堂4']}"
13
    )
14

15
    unique_marker = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
16

17
    body = (
18
        f"{student_name} 同學哈囉!\\n\\n"
19
        "這是你的隨堂成績:\\n\\n"
20
        f"{scores}\\n\\n"
21
        "如果有任何問題或是作業需要補交都記得要跟我說一下哦。\\n\\n"
22
        "TA 莊鈞凱\\n"
23
        "祝你下週期中考試每一科都💯\\n\\n"
24
        "Web: <https://kingkaizhuang.github.io/\\n\\n>"
25
        f"唯一標記：{unique_marker}"
26
    )
27

28
    message = MIMEMultipart()
29
    message["From"] = f"基礎數學助教 <{smtp_user}>"
30
    message["To"] = email_to
31
    message["Subject"] = subject
32
    message.attach(MIMEText(body, "plain"))
33

34
    server.sendmail(smtp_user, email_to.split(", "), message.as_string())
35
    print(f"已發送成績給 {student_name_full} ({email_to})")

6. 關閉伺服器連接

在所有郵件發送完畢後，關閉 SMTP 伺服器連接。

1
server.quit()

完整程式碼

1
import pandas as pd
2
import smtplib
3
from email.mime.text import MIMEText
4
from email.mime.multipart import MIMEMultipart
5
from datetime import datetime
6

7
file_path = 'ta-score-mid.xlsx'
8
data = pd.read_excel(file_path, sheet_name='工作表1')
9
data = data[['班級', '學號', '姓名', '隨堂1', '隨堂2', '隨堂3', '隨堂4']]
10

11
smtp_server = "smtp.gmail.com"
12
smtp_port = 587
13
smtp_user = "your_email@gmail.com"  # 替換為您的 Gmail 地址
14
smtp_password = "your_app_specific_password"  # 替換為您的應用程式密碼
15

16
server = smtplib.SMTP(smtp_server, smtp_port)
17
server.starttls()
18
server.login(smtp_user, smtp_password)
19

20
for index, row in data.iterrows():
21
    student_id = row['學號'].lower()
22
    student_name_full = row['姓名']
23
    student_name = student_name_full[-2:]
24
    email_to = f"{student_id}@stust.edu.tw, {student_id}@office.stust.edu.tw"
25
    subject = "基礎數學 期中作業成績確認"
26

27
    scores = (
28
        f"隨堂1: {row['隨堂1']}\\n"
29
        f"隨堂2: {row['隨堂2']}\\n"
30
        f"隨堂3: {row['隨堂3']}\\n"
31
        f"隨堂4: {row['隨堂4']}"
32
    )
33

34
    unique_marker = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
35

36
    body = (
37
        f"{student_name} 同學哈囉!\\n\\n"
38
        "這是你的隨堂成績:\\n\\n"
39
        f"{scores}\\n\\n"
40
        "如果有任何問題或是作業需要補交都記得要跟我說一下哦。\\n\\n"
41
        "TA 莊鈞凱\\n"
42
        "祝你下週期中考試每一科都💯\\n\\n"
43
        "Web: <https://kingkaizhuang.github.io/\\n\\n>"
44
        f"唯一標記：{unique_marker}"
45
    )
46

47
    message = MIMEMultipart()
48
    message["From"] = f"基礎數學助教 <{smtp_user}>"
49
    message["To"] = email_to
50
    message["Subject"] = subject
51
    message.attach(MIMEText(body, "plain"))
52

53
    server.sendmail(smtp_user, email_to.split(", "), message.as_string())
54
    print(f"已發送成績給 {student_name_full} ({email_to})")
55

56
server.quit(

StackPenguin