Python 的 splitlines() 方法完全解析！使用方式與應用範例

By 佐川 直弘 | Naohiro Sagawa (運営者)

※記事内に広告を含みます。Amazonアソシエイトとして適格販売により収入を得ています。

1. 前言

Python 是一種因簡潔與靈活性而受到眾多程式設計師喜愛的程式語言。其中，字串處理是日常開發中經常進行的任務之一。尤其在處理大量資料或複雜文字內容時，Python 的標準字串處理方法非常實用。

這次要介紹的 splitlines() 方法，是 Python 中用來依據換行符號分割字串的功能。例如，當你想將文字檔的資料依行分割，或是將多行字串轉換成清單格式時，這個方法會非常有幫助。

本文將詳細說明 splitlines() 方法的基本用法、實際應用範例，以及使用時需要注意的地方與最佳實踐。我們也會搭配容易理解的程式碼範例，即使是初學者也能輕鬆上手，歡迎參考學習！

2. 什麼是 splitlines() 方法

Python 的 splitlines() 方法是一個實用的工具，可根據換行符號將字串切割並以清單形式返回。這是 Python 中眾多字串處理方法之一，特別適合需要依行拆解文字資料的情境。

以下將說明 splitlines() 方法的基本概念與用途，並比較與類似方法 split() 的差異。

基本說明與用途

splitlines() 方法會自動識別字串中的各種換行符（如：\n、\r、\r\n）並進行分割。其主要特點如下：

• 不受換行符種類限制，能自動處理各種格式。
• 可透過選擇性參數 keepends 控制是否保留換行符。
• 若輸入為空字串，則返回空清單。

主要用途：

• 處理文字檔案：將文字資料按行分割，方便操作。
• 日誌分析：逐行處理 log 檔案資料。
• 資料整理：將多行輸入字串分割並結構化。

splitlines() 與 split() 的差異

split() 方法同樣可以分割字串，因此常被拿來與 splitlines() 比較，但它們的行為其實不同，以下是主要差異：

程式碼範例

以下是比較兩種方法（split() 與 splitlines()）行為差異的程式碼範例：

# 測試用字串
text = "line1
line2
line3"

# 使用 splitlines()
lines = text.splitlines()
print(lines)  # 輸出: ['line1', 'line2', 'line3']

# 使用 split() 並指定換行符號
lines_split = text.split('
')
print(lines_split)  # 輸出: ['line1', 'line2
', 'line3']

3. splitlines() 的使用方法

本節將詳細介紹 Python 中 splitlines() 方法的基本使用方式。從語法與參數說明開始，透過實際程式碼範例，讓你了解這個方法的便利性。

基本語法

splitlines() 方法的基本語法如下：

string.splitlines(keepends=False)

• string: 要進行分割的字串。
• keepends: 是否保留換行符號，可透過此參數控制。
• 預設值為 False（不保留換行符）。
• 若設定為 True，則會保留每行末尾的換行符號。

參數 keepends 的效果

透過設定 keepends 的值，可以看到不同的輸出結果：

text = "line1
line2
line3"

# keepends=False（預設）
print(text.splitlines(keepends=False))
# 輸出: ['line1', 'line2', 'line3']

# keepends=True
print(text.splitlines(keepends=True))
# 輸出: ['line1
', 'line2
', 'line3']

• 當 keepends=False 時，換行符號會被移除，每行內容作為清單元素。
• 當 keepends=True 時，每行結尾的換行符號會被保留。

範例：基本用法

以下是 splitlines() 的基本應用範例：

# 範例字串
sample_text = "こんにちは
Python
プログラミング"

# 不保留換行符
lines = sample_text.splitlines()
print(lines)
# 輸出: ['こんにちは', 'Python', 'プログラミング']

# 保留換行符
lines_with_ends = sample_text.splitlines(keepends=True)
print(lines_with_ends)
# 輸出: ['こんにちは
', 'Python
', 'プログラミング']

範例：空字串的情況

當處理空字串時，splitlines() 會回傳一個空的清單：

empty_text = ""
print(empty_text.splitlines())
# 輸出: []

範例：沒有換行符的字串

如果字串中不包含任何換行符，splitlines() 將整段文字作為單一元素返回：

single_line = "Pythonは楽しい"
print(single_line.splitlines())
# 輸出: ['Pythonは楽しい']

4. splitlines() 的實際應用範例

本節將介紹幾個實際情境中使用 Python splitlines() 方法的案例。透過這些例子，你可以更深入了解它在實務上的應用方式。

1. 處理文字檔案的每一行

splitlines() 在需要逐行處理文字檔案時非常實用。以下範例展示如何讀取檔案並處理每一行內容：

# 將檔案內容轉為清單，每一行為一個元素
with open("sample.txt", "r", encoding="utf-8") as file:
    content = file.read()
    lines = content.splitlines()

# 輸出每一行
for line in lines:
    print(line)

應用範例：

• 在檔案中搜尋特定關鍵字。
• 按行分析資料內容。

2. 整理使用者輸入

當使用者輸入的是多行文字資料時，可透過 splitlines() 將其依行分割，方便進一步處理：

# 使用者輸入的多行資料
user_input = """名前: 佐藤
年齢: 25
職業: エンジニア"""

# 依行分割輸入內容
lines = user_input.splitlines()

# 格式化輸出
for line in lines:
    key, value = line.split(": ")
    print(f"{key}是{value}")

輸出範例：

名前是佐藤
年齢是25
職業是エンジニア

3. 用於網頁爬蟲時的資料整理

當透過網頁爬蟲獲取的文字資料為多行格式時，splitlines() 能有效將資料分割為行，便於處理：

import requests

# 擷取網頁內容
url = "https://example.com"
response = requests.get(url)

# 將網頁文字內容依行分割
lines = response.text.splitlines()

# 顯示前10行資料
for line in lines[:10]:
    print(line)

應用範例：

• 前處理爬取到的文字資料。
• 分析 HTML 或日誌等格式化資料。

4. 分析日誌檔案

在處理伺服器日誌或錯誤紀錄檔時，splitlines() 可協助依行讀取與分析：

# 範例日誌資料
log_data = """2025-01-24 10:00:00 INFO User logged in
2025-01-24 10:05:00 ERROR Connection failed
2025-01-24 10:10:00 INFO User logged out"""

# 依行分割
log_lines = log_data.splitlines()

# 篩選出錯誤的行
for line in log_lines:
    if "ERROR" in line:
        print(line)

輸出範例：

2025-01-24 10:05:00 ERROR Connection failed

5. 當需要保留換行符號時

若處理時需要保留原本的換行符號，可使用 keepends=True 參數：

# 保留換行符號的例子
text = "Line1
Line2
Line3"

# 使用 keepends 參數
lines = text.splitlines(keepends=True)
print(lines)
# 輸出: ['Line1\n', 'Line2\r\n', 'Line3']

應用範例：

• 需要分析不同類型的換行符時。
• 在保留原始格式的情況下進行資料處理。

5. splitlines() 的應用場景

Python 的 splitlines() 方法提供了方便的功能，可依據換行符號將字串分割。以下介紹幾個實際工作中可活用此方法的情境，搭配具體範例說明。

1. 資料分析

splitlines() 對於分析純文字格式資料特別有效。尤其是像 CSV 或日誌檔案等按行儲存的資料，非常適合使用此方法來進行處理。

範例：分析日誌資料

log_data = """2025-01-24 10:00:00 INFO Starting process
2025-01-24 10:05:00 ERROR Failed to connect to database
2025-01-24 10:10:00 INFO Process completed"""

# 依行分割
log_lines = log_data.splitlines()

# 篩選出錯誤訊息的行
error_logs = [line for line in log_lines if "ERROR" in line]
print("錯誤行:", error_logs)

應用範例：

• 從日誌檔中擷取錯誤或警告訊息。
• 對每一行進行統計或分類分析。

2. 操作文字檔案

在處理設定檔或文件時，常需要逐行讀取與操作。這是 splitlines() 非常實用的場景之一。

範例：處理設定檔

# 範例設定檔內容
config_data = """[Database]
host = localhost
port = 5432

[User]
name = admin
password = secret"""

# 將設定內容依行分割
config_lines = config_data.splitlines()

# 移除註解與空行
filtered_lines = [line for line in config_lines if line.strip() and not line.startswith("#")]
print(filtered_lines)

應用範例：

• 自動解析設定檔或腳本內容。
• 從文件中提取有效資訊。

3. 用於 Web 開發

在 Web 應用中，常會處理使用者輸入的多行文字。splitlines() 可協助有效拆分並整理這些資料。

範例：格式化使用者輸入

# 使用者輸入範例
user_input = """Line1
Line2
Line3"""

# 依行分割
lines = user_input.splitlines()

# 格式化輸出
formatted_output = "\n".join(f"第 {i+1} 行: {line}" for i, line in enumerate(lines))
print(formatted_output)

輸出範例：

第 1 行: Line1
第 2 行: Line2
第 3 行: Line3

應用範例：

• 驗證與整理使用者輸入。
• 在收集資料後進行前處理。

4. 整理爬蟲資料

爬蟲取得的網頁內容常包含多行資料，透過 splitlines() 可快速整理並提取需要的部分。

範例：HTML 文字的行分割

import requests

# 範例 HTML 內容
html_content = """<html>
<head><title>Example</title></head>
<body>
<p>這是一個範例。</p>
</body>
</html>"""

# 將 HTML 按行分割
html_lines = html_content.splitlines()

# 輸出每一行內容
for line in html_lines:
    print(line.strip())

應用範例：

• 分析 HTML 或 JSON 等格式的資料。
• 爬蟲後的資料清理與處理。

5. 偵錯（Debug）時的使用

在程式除錯階段，遇到多行錯誤訊息或堆疊追蹤資料時，使用 splitlines() 可使其更易於閱讀與分析。

範例：分割錯誤訊息

error_message = """Traceback (most recent call last):
File "main.py", line 10, in <module>
ValueError: invalid literal for int() with base 10: 'abc'"""

# 依行分割
error_lines = error_message.splitlines()

# 每行加上行號輸出
for i, line in enumerate(error_lines, start=1):
    print(f"{i}: {line}")

應用範例：

• 提升錯誤日誌的可讀性。
• 分析多行錯誤訊息的內容。

6. 注意事項與最佳實踐

Python 的 splitlines() 方法是一個非常實用的字串處理工具，但在使用時也有一些需要留意的地方。同時，若能掌握一些最佳實踐，將有助於更有效地運用此方法。

注意事項

1. 換行符號混用時的行為
   splitlines() 能夠自動識別如 \n、\r、\r\n 等不同類型的換行符號並進行分割。這通常是優點，但若你希望只根據特定的換行符分割，則應改用 split('') 等其他方法。範例：

text = "line1
line2
line3"
print(text.splitlines())
# 輸出: ['line1', 'line2', 'line3']

由於所有換行符號都會被處理，若你希望保留特定的換行符，需特別注意。

2. 空行的處理
   splitlines() 會保留空行，這些也會作為清單中的一個元素。如果你不希望包含空行，就必須另外過濾。範例：移除空行

text = "line1

line2
"
lines = text.splitlines()
filtered_lines = [line for line in lines if line.strip()]
print(filtered_lines)
# 輸出: ['line1', 'line2']

3. 處理大型資料時的資源消耗
   當資料量龐大時，使用 splitlines() 可能導致記憶體消耗增加。在處理大型檔案或字串時，應留意資料處理的設計方式。
4. 是否保留換行符號的影響
   如果未設定 keepends=True，換行符號將會被移除。當你需要保留原始格式時，請記得啟用此參數。

最佳實踐

1. 需要保留換行符號時使用 keepends=True
   當你希望保留每一行末尾的換行符號時，可使用 keepends=True 參數來保持原始格式。範例：

text = "line1
line2
line3"
lines = text.splitlines(keepends=True)
print(lines)
# 輸出: ['line1\n', 'line2\n', 'line3']

2. 利用列表推導式快速過濾空行
   若要去除空行，使用列表推導式是一種簡潔且高效的方式。範例：

lines = ["line1", "", "line2", " "]
filtered = [line for line in lines if line.strip()]
print(filtered)
# 輸出: ['line1', 'line2']

3. 視需求選擇 splitlines() 或 split()
   如果你只想根據特定符號（如 \n）分割字串，使用 split() 可能會更合適。範例：

text = "line1
line2
line3"
print(text.split('\n'))
# 輸出: ['line1', 'line2\r', 'line3']

4. 處理大量資料時使用生成器（Generator）
   若需處理大型檔案，建議使用生成器按行處理，以降低記憶體負擔。範例：

def read_lines(file_path):
    with open(file_path, 'r', encoding='utf-8') as file:
        for line in file:
            yield line.strip()

for line in read_lines("large_file.txt"):
    print(line)

5. 加入錯誤處理
   考慮到輸入資料可能不符合預期格式，加入適當的錯誤處理機制也很重要。範例：

try:
    text = None  # 錯誤的輸入
    lines = text.splitlines()
except AttributeError as e:
    print("錯誤：無效的輸入 -", e)

7. 常見問題（FAQ）

以下是關於 Python splitlines() 方法的常見問題整理，從初學者常見疑問到進階使用上的注意事項皆有涵蓋。

Q1: splitlines() 和 split(‘\n’) 有什麼不同？

A1：
splitlines() 會自動識別多種換行符號（例如：\n、\r、\r\n）並進行分割，而 split('\n') 則只會針對 \n 進行分割。

範例：

text = "line1
line2
line3"

# 使用 splitlines()
print(text.splitlines())  
# 輸出: ['line1', 'line2', 'line3']

# 使用 split('\n')
print(text.split('\n'))  
# 輸出: ['line1', 'line2\r', 'line3']

Q2: splitlines() 會保留空行嗎？

A2：
會的，splitlines() 會將空行作為清單的一個元素保留。如果想排除空行，可搭配 strip() 進行過濾。

範例：排除空行

text = "line1

line2"
lines = text.splitlines()
filtered_lines = [line for line in lines if line.strip()]
print(filtered_lines)
# 輸出: ['line1', 'line2']

Q3: splitlines() 會區分大小寫嗎？

A3：
不會。splitlines() 只根據換行符號進行分割，不會檢查字串的內容，因此與大小寫無關。

Q4: splitlines() 可以用在位元組字串（bytes）上嗎？

A4：
可以。splitlines() 也適用於位元組字串（以 b"" 表示），但回傳結果會是位元組類型的清單。

範例：

text = b"line1
line2
line3"
lines = text.splitlines()
print(lines)
# 輸出: [b'line1', b'line2', b'line3']

Q5: 什麼時候該使用 keepends 參數？

A5：
當你希望保留每一行末尾的換行符號（例如進行格式分析或保留原樣）時，請設定 keepends=True。

範例：

text = "line1
line2
line3"
lines = text.splitlines(keepends=True)
print(lines)
# 輸出: ['line1\n', 'line2\n', 'line3']

Q6: splitlines() 從哪個 Python 版本開始可以使用？

A6：
splitlines() 自 Python 2.0 起即已提供，目前在所有版本的 Python 3 中也都可以正常使用。不過，由於 Python 2 已停止支援，建議使用 Python 3。

Q7: 如果字串中沒有換行符號，splitlines() 會怎樣？

A7：
若字串中完全不含換行符號，splitlines() 會將整個字串作為一個元素放入清單中。

範例：

text = "Python 很有趣"
lines = text.splitlines()
print(lines)
# 輸出: ['Python 很有趣']

Q8: 哪些情況下適合使用 splitlines()？

A8：
以下情況特別適合使用 splitlines()：

• 需要將文字檔逐行處理時
• 整理使用者輸入的多行資料時
• 處理含多種換行格式的資料時
• 分析日誌或 HTML 文字資料時

Q9: splitlines() 的效能如何？

A9：
在一般文字處理情境下，splitlines() 效能表現良好。但若處理大量資料，需留意記憶體使用量。建議搭配檔案逐行讀取或生成器使用。

Q10: 使用 splitlines() 時最重要的注意事項是什麼？

A10：

• 能簡化多種換行符號的處理。
• 若需排除空行或保留格式，請搭配 strip() 或 keepends 使用。
• 可視需求選擇與其他字串處理方法（如 split()）搭配使用。

8. 總結

本文詳細介紹了 Python 的 splitlines() 方法。從基本用法到實務應用範例，再到注意事項與最佳實踐，內容涵蓋初學者與進階使用者所需的重點知識。

文章回顧

1. splitlines() 方法的概述

• splitlines() 是用來根據換行符號分割字串並回傳清單的工具，能自動辨識多種換行符（如：\n、\r、\r\n）。

1. 基本使用方法

• 可使用參數 keepends 控制是否保留換行符號，根據使用場景靈活操作。

1. 實際應用與操作範例

• 適用於處理文字檔、日誌資料、網頁爬蟲資料或使用者輸入等多種場景。

1. 注意事項與最佳實踐

• 需留意空行與大量資料處理的方式，並理解與其他字串處理方法的差異，才能撰寫出更高效的程式碼。

1. 常見問題（FAQ）

• 針對初學者常見疑問與進階應用提供實例解說，加深對 splitlines() 的理解。

使用 splitlines() 的優點

• 高效率的字串處理：能輕鬆處理含有換行的複雜資料。
• 支援多種資料格式：例如 CSV、日誌檔、爬蟲內容等，都可應用。
• 靈活且易於上手：可搭配 keepends 與列表推導式處理多樣任務。

下一步建議

1. 動手實作範例程式碼：
   親自嘗試文章中的範例，可快速熟悉 splitlines() 的使用方式。
2. 學習其他字串處理方法：
   像是 split()、join()、strip() 等方法也非常實用，根據不同需求選擇合適的方法。
3. 應用於實際專案：
   透過 log 分析或資料整理等實務操作，累積實戰經驗，加深理解。

希望這篇文章能幫助你更有效地進行 Python 字串處理，提升你的開發技巧。善用 splitlines()，讓你在處理文字資料時更加順利！