🔧解決 Python 腳本「一閃而逝」：用 PowerShell 正確執行與除錯的完整指南（含 venv、參數與 .bat 範例）

-

 身為軟體工程師，我最常被朋友問到的 Windows 問題之一是：「雙擊 .py 之後視窗閃一下就消失了，怎麼辦？」

這篇文章會用非工程背景也看得懂的方式，教你在 PowerShell 正確啟動 Python 虛擬環境（venv）、以指令列參數執行腳本、避免視窗閃退、並在需要時用 .bat 批次檔一鍵執行。文中所有程式碼範例均為重新撰寫、僅用於教學示範。

為什麼會「閃退」？

  1. 腳本本來就需要參數：沒有帶 --source、--out 這類必填參數，程式立即結束。

  2. 錯誤訊息來不及看：直接雙擊會開啟一個臨時視窗，程式結束就關掉。

  3. 工作目錄不對：雙擊時的「目前資料夾」常是 C:\Windows\System32，相對路徑全失效。

  4. 少套件：例如需要 pandas、openpyxl，但環境沒安裝。

  5. 沒用虛擬環境：系統 Python 與專案需求版本、套件不同步。

一步步正確執行（最穩妥做法）

以下假設你的專案放在：D:\Projects\ReportTool

1) 打開 PowerShell 並進到專案資料夾

cd "D:\Projects\ReportTool"

2) 啟用 venv（PowerShell 版）

虛擬環境資料夾常命名為 .venv（前面有小數點）。


.\.venv\Scripts\Activate.ps1

如果出現「執行原則限制」：

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned -Force
.\.venv\Scripts\Activate.ps1

3) 安裝（或更新）必要套件

pip install -U pip
pip install pandas openpyxl xlsxwriter

4) 用參數執行腳本（範例）

假設你的腳本檔叫 combine_reports.py，它需要兩個參數：來源資料夾與輸出檔案。

python -X dev -u ".\combine_reports.py" --source ".\input" --out ".\merged.xlsx"

  • -X dev：顯示更完整的除錯訊息。

  • -u：不快取輸出，讓訊息即時印出。

  • 路徑有空白或中文，一律加引號。

教學用 Python 範例（全新撰寫）

這是一個「需要參數」的示範腳本，會把指定資料夾中每個 Excel 的第一個工作表合併進一個新檔。

你可以將此檔命名為 combine_reports.py 放在專案根目錄。


# combine_reports.py  (教學示範用)
# 需求：pip install pandas openpyxl
from pathlib import Path
import argparse
import sys
import pandas as pd

def parse_args():
    p = argparse.ArgumentParser(
        description="Combine the first worksheet of all Excel files in a folder."
    )
    p.add_argument("--source", required=True, help="Folder that contains Excel files")
    p.add_argument("--out",    required=True, help="Output Excel file path")
    p.add_argument("--pattern", default="*.xlsx", help="File pattern (default: *.xlsx)")
    return p.parse_args()

def main():
    args = parse_args()
    src = Path(args.source)
    if not src.exists() or not src.is_dir():
        print(f"[ERROR] Source folder not found: {src}")
        sys.exit(2)

    files = sorted([p for p in src.glob(args.pattern) if not p.name.startswith("~$")])
    if not files:
        print("[WARN] No Excel files found. Nothing to do.")
        sys.exit(0)

    with pd.ExcelWriter(args.out, engine="openpyxl") as writer:
        for f in files:
            try:
                df = pd.read_excel(f, sheet_name=0)
            except Exception as e:
                print(f"[SKIP] {f.name} ({e})")
                continue
            # 以檔名（去副檔名）當成工作表名稱，過長時截斷至 31 字
            sheet = f.stem[:31]
            df.to_excel(writer, index=False, sheet_name=sheet)

    print(f"[OK] Combined {len(files)} file(s) -> {args.out}")

if __name__ == "__main__":
    # 讓任何未處理的例外都能顯示在主控台
    try:
        main()
    except Exception as ex:
        import traceback
        traceback.print_exc()
        input("\n程式發生錯誤（已顯示堆疊訊息）。按 Enter 關閉...")

執行方式：

python ".\combine_reports.py" --source ".\input" --out ".\merged.xlsx"

一鍵執行的 .bat（避免視窗秒關）

把下面內容存成 run_combine.bat，丟在專案根目錄。雙擊執行即可，視窗會保留讓你看到訊息。

@echo off
setlocal
chcp 65001 >nul

set "ROOT=%~dp0"
set "SRC=%ROOT%input"
set "OUT=%ROOT%merged.xlsx"

if exist "%ROOT%.venv\Scripts\python.exe" (
  "%ROOT%.venv\Scripts\python.exe" "%ROOT%combine_reports.py" --source "%SRC%" --out "%OUT%"
) else (
  py -3 "%ROOT%combine_reports.py" --source "%SRC%" --out "%OUT%"
)

echo.
echo 任務完成，若有錯誤請往上捲動檢查訊息。
pause
endlocal

常見錯誤與排除

1) …Activate.ps1 無法辨識

  • 路徑或檔名打錯：請確認是 .venv\Scripts\Activate.ps1（大小寫無所謂，但 .venv 前面的點不能少）。

  • 你在對的資料夾嗎？用 pwd 檢查目前位置。

2) running scripts is disabled

  • 設定允許執行本機腳本：

    Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned -Force

3) ModuleNotFoundError（少套件）

  • 在已啟用的 venv 裡安裝：

    pip install pandas openpyxl xlsxwriter

4) 找不到檔案或資料夾

  • 路徑含空白或中文，記得用引號："D:\My Data\input"。

  • 先用 ls 或 dir 確認檔案真的存在。

5) 看不到錯誤就關掉了

  • 用 PowerShell 執行，不要雙擊。

  • 或在程式最後加上 input("按 Enter 關閉...")。

  • 或用本文提供的 .bat（含 pause）。

最佳實務建議（Engineer Tips）

  • 固定使用 venv：不同專案不同依賴，避免「全域地獄」。

  • 參數要有 --help：像本文的 argparse，讓使用者知道怎麼跑。

  • 加入 log 機制：出錯時寫入 error.log 方便定位。

  • 明確的輸出與返回碼：例如找不到檔案回傳 exit 2，自動化流程更好接。

  • 在指令前加 -X dev：開發模式訊息更完整，除錯效率高。

範例工作流程（從零到跑起來）

  1. 建資料夾：D:\Projects\ReportTool

  2. 建 input\ 資料夾，把要合併的 Excel 放進去

  3. 建立 venv 並啟動（一次性）：

    cd "D:\Projects\ReportTool"
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -U pip pandas openpyxl xlsxwriter

  4. 存好 combine_reports.py

  5. 執行：

    python ".\combine_reports.py" --source ".\input" --out ".\merged.xlsx"

  6. 想一鍵：存好 run_combine.bat，以後直接雙擊。

FAQ

Q：我沒有 .venv 這個資料夾怎麼辦？
A：在專案根目錄執行 python -m venv .venv 建一個，然後照文內步驟啟用。

Q：一定要用 PowerShell 嗎？
A：推薦。若用 CMD，啟用 venv 的指令是 .\.venv\Scripts\activate.bat。

Q：Excel 合併卡格式？
A：先確認每個檔案第一個工作表結構一致；必要時在讀入後補齊欄位或統一欄名。

結語

「視窗一閃就沒了」其實是執行方式與參數/環境沒有設定妥當。
掌握本文三件事：PowerShell 執行、venv 啟用、指令列參數，再搭配 .bat 做一鍵化，日常處理檔案或報表就能穩定又省心。

有任何步驟卡住或想擴充更多自動化（例如自動搬檔、產出多個報表），把錯誤訊息或需求貼給我，我會用工程師的方式幫你拆解解決。

留言

張貼留言

這個網誌中的熱門文章

🔍Vue.js 專案錯誤排查：解決 numericFields is not defined 與合併儲存格邏輯最佳化

-
  前言 在前端開發專案中，處理表格數據與 Excel 匯出是常見的需求。 最近在專案中，遇到一個常見但讓人頭痛的錯誤訊息： Uncaught ReferenceError: numericFields is not defined 本文將用簡單的方式，帶你了解這個錯誤的成因、如何修改程式碼，以及如何最佳化「合併儲存格」與「數值加總」的邏輯。 問題場景：表格合併與數值加總 專案中需要達成以下功能： 同一個 APS_PLAN_NO 下，若 TFT4 相同，則 TFT5 欄位要合併。 數值欄位要加總，並以千分位格式輸出。 匯出到 Excel 時，也要套用相同邏輯。 在 Vue 的 rowSpans 計算邏輯中，初始版本如下： const rowSpans = computed ( () => { const rows = filteredData. value const spans = rows. map ( () => { const obj = {} tableHeaders. value . forEach ( key => obj[key] = 0 ) return obj }) ... return spans }) 但是，當我們在 exportToExcel() 使用時，出現了以下錯誤： Uncaught ReferenceError: numericFields is not defined 錯誤原因 這個錯誤訊息代表： 👉 numericFields 在程式中根本沒有宣告，所以瀏覽器不知道它是什麼。 舉例來說，假設我們在程式裡寫了這樣的判斷： if (numericFields. includes (key)) { // 處理數值欄位 } 但其實 numericFields 沒有定義，程式就會直接報錯。 解決方案：定義 numericFields ...
閱讀完整內容

🔎EF Core 連 Oracle 出現 ORA-00600 [kpp_concatq:2] 的完整排錯指南（含 EF Core ToString/CultureInfo 錯誤）

-
  摘要（Meta Description） 在 .NET EF Core 對 Oracle 查詢時，若遭遇 ORA-00600 [kpp_concatq:2] ，多半是查詢優化器在字串型別轉換或重寫（Query Transformation）時踩到版本 Bug。本文以實戰日誌形式，示範如何用 FromSqlRaw + 參數型別/長度對齊 + CAST + Hint 立即止血，並處理 EF Core 另一個常見錯誤：「 CultureInfo 常值被傳進 ToString 造成可能記憶體外洩 」。附可直接套用的程式碼。 目錄 錯誤現象 根因分析 三步驟「立即止血」 安全重構：可直接貼用的程式碼 進階避雷：CTE/MATERIALIZE 與 View 包裝 EF Core ToString / CultureInfo 錯誤的正確處理 版本與長期解法（根治） 效能與穩定性小技巧 檢查清單（Checklist） FAQ 結語 錯誤現象 常見堆疊片段如下（節錄）： Oracle .ManagedDataAccess .Client .OracleException ( 0 x80004005): ORA-00600 : 內部錯誤代碼, 引數: [kpp_concatq:2] , [4] , [3] ...
閱讀完整內容

🛠【ASP.NET Core + Oracle】解決 ORA-00904 "FALSE": 無效的 ID 錯誤與資料欄位動態插入顯示問題

-
  🔍 問題描述 在開發群創光電內部的 APS 排程系統（使用 ASP.NET Core + Vue 3 + Oracle），前端發生多筆錯誤訊息： Request failed with status code 500 Oracle.ManagedDataAccess.Client.OracleException: ORA-00904: "FALSE": 無效的 ID 這是 Oracle 資料庫對布林值處理不一致造成的錯誤，我們後端嘗試將某個欄位 .Where(x => x.FLAG == false) 寫法，經由 EF Core 轉成 SQL： SELECT * FROM TABLE WHERE FLAG = FALSE 而 Oracle 並不支援 FALSE 關鍵字作為布林值 → 導致查詢失敗。 🔧 解決方案 1：避免布林值直接進入 LINQ to SQL EF Core + Oracle 不支援下列語法： .Where(x => x.IsActive == false) // ❌ Oracle 無法解析 FALSE ✅ 解法 ：將布林判斷移至 .ToList() 之後，變成記憶體篩選： var list = await db.Table.Where(x => x.Version == ver).ToListAsync(); var filtered = list.Where(x => !x.IsActive).ToList(); // ✅ 在記憶體中比對布林 🔧 解決方案 2：安全轉換 SEQ_NO 為 Decimal 後端為了將前段表 APSZFRONT 的 SEQ_NO 與 APSZLCM 的 APS_PLAN_SEQ 對應，用到了這段程式碼： Convert.ToDecimal(front.SEQ_NO) 但一旦 SEQ_NO 含有英文字母（例如 GN140CHCAAE90S_20250811_1_531 ），就會丟出 FormatException → 造成 HTTP 500。 ✅ 正確寫法（TryParse 避免失敗） ： de...
閱讀完整內容