2025年12月16日 星期二

【第二篇】本機開發遇到 Vite 錯誤:小白一步步排查指南

【第二篇】本機開發遇到 Vite 錯誤:小白一步一步完全排查指南

適用:本地使用 php artisan serve 出現 ViteManifestNotFoundException

步驟

  1. 開 Terminal
  2. cd 到專案
  3. npm install
  4. npm run dev
  5. 刷新網頁

2025年12月9日 星期二

【第一篇】什麼是 ViteManifestNotFoundException?用人話解釋

【第一篇】ViteManifestNotFoundException 到底在說什麼?

如果你正在學 Laravel,然後突然跳出一個:

ViteManifestNotFoundException
到底在共三小?

其實它的意思超簡單:

Laravel 找不到「前端打包好的檔案」

換成人話兩種原因:

  1. 未執行 npm run dev
  2. 上線時沒執行 npm run build
Laravel:我要找前端檔案!
你:我忘記開 Vite / 忘記打包
Laravel:報錯讓你知道!

下篇告訴你怎麼修好。

2025年12月8日 星期一

《文組生也能學會寫程式:用 Cursor 幫你看懂程式碼,開啟你的自學之路》

文組生也能學會寫程式:用 Cursor 幫你看懂程式碼,開啟你的自學之路

很多人以為程式只有理工科才能接觸,但我想告訴你:文組生也完全可以寫程式,而且可以寫得很好。
你需要的不是天賦,而是正確的學習方法與工具。

在我自學與教學的過程中,我發現一個強大的工具 —— Cursor。它能幫你把看不懂的程式碼,用最白話的方式解釋給你聽。這也讓我決定把這些經驗整理成文章,未來希望能開課,帶更多人踏進程式世界。

為什麼文組生也能靠 Cursor 開始寫程式?

如果你是文組背景,可能會遇到兩個痛點:

  • 看不懂程式碼在做什麼
  • 網路教學講得太難、太抽象

而 Cursor 解決的正是這兩個問題。

Cursor 是一個結合 AI 的程式開發工具,它可以:

  • 把程式碼翻譯成白話文,像有老師坐在你旁邊講解。
  • 讀懂你的專案整體脈絡,比一般 ChatGPT 更準確。
  • 幫你找錯誤、給解法,讓你學得更快。
  • 甚至生成技術文件或教學內容,協助你整理學習。

這對沒有程式基礎的人來說,就是最佳的起點。

讓我示範:Cursor 怎麼把程式碼講到你聽得懂?

以下是一小段常見的 Laravel 程式碼:

public function store(Request $request)
{
    $request->validate(['task' => 'required']);
    Auth::user()->todos()->create($request->all());
    return redirect()->route('todos.index');
}

文組同學看到這段可能會想:「這是什麼。」 但如果你用 Cursor 的 Explain Code,它會告訴你:

  • 這段程式碼負責「新增一筆代辦事項」。
  • 先驗證你有輸入 task。
  • 拿到登入者的資料,把代辦事項記錄到資料庫。
  • 最後導回列表頁。

瞬間,你就能理解這段程式碼的邏輯。

Cursor 是你學習程式的加速器,而不是作弊工具

很多人誤會 AI 是用來取代思考的,但其實最有價值的,是:

  • AI 幫你簡化理解難度
  • 你保留程式邏輯的學習成長

就像一個會把艱深內容「翻譯成你懂的語言」的私人家教。

寫這篇文章的目的:我正在準備開課(文組生/零基礎友善)

我正在整理一系列內容,未來打算開課,專門帶:

  • 文組生
  • 零基礎自學者
  • 跨領域想轉職的人

課程內容會以「看得懂 → 寫得出 → 解決問題」為主軸,不會用艱澀的專有名詞轟炸你,而是帶你:

  • 用白話理解每段程式碼
  • 用 Cursor 減輕學習痛苦
  • 一步一步完成你的第一個作品

如果你覺得程式語言都像外星文字,那這堂課就是為你設計的。

為什麼我寫部落格?因為我希望你看到我的教學風格

寫這些文章不只是一種分享,也是讓你認識:

  • 我的教學方式
  • 我的解釋能力
  • 我如何用工具協助學習

未來你會在這個部落格看到更多:

  • 白話解釋框架(例如 Laravel、Node.js)
  • 自學指南
  • AI 工具輔助學程式的方法
  • 新手也能看得懂的技術圖解

如果你願意跟著我一步一步開始,你會發現寫程式沒有你想得那麼難。

最後想對你說…

程式不是天才的專利。它只是一種語言,而 Cursor 會幫你把它翻成你聽得懂的中文。

你只需要願意開始,剩下的我會陪你邁過去。


如果你希望我開更完整的系列文章、影片,甚至想加入未來課程的搶先名單,都可以留言告訴我。

2025年12月3日 星期三

Laravel 路由完全攻略:從零開始理解網站的導航系統

🚀 網站開發核心:超簡單理解 Laravel 路由系統 (Route)

## 前言:為什麼路由這麼重要?

如果你剛開始學習網站開發,「路由」這個詞可能聽起來很陌生。但其實,你每天都在使用路由——只是你沒有意識到而已。

當你在瀏覽器輸入 facebook.com/profile 的時候,Facebook 是怎麼知道要顯示你的個人資料頁面,而不是首頁呢?答案就是:路由

今天,我要用最簡單的方式,帶你徹底理解 Laravel 框架中的路由系統。不管你是文組背景還是完全沒有程式經驗,看完這篇文章後,你都能輕鬆掌握路由的核心概念!


## 一、路由是什麼?用生活例子來理解

🏢 想像你走進一棟大樓

假設你今天去一棟辦公大樓找朋友,你會怎麼做?

  1. 走進大樓大門
  2. 看指示牌:「3樓 - 會議室」「5樓 - 人資部」「7樓 - 工程部」
  3. 根據指示牌,搭電梯到對應樓層
  4. 找到你要去的地方

網站的路由,就是這棟大樓的指示牌!

使用者輸入網址(走進大樓)
    ↓
路由系統判斷(看指示牌)
    ↓
導向對應的功能(搭電梯到對應樓層)
    ↓
顯示正確的頁面(找到目的地)

📮 另一個比喻:郵局分信員

你也可以把路由想像成郵局的分信員:

  • 信件 = 使用者的請求
  • 地址 = 網址 URL
  • 分信員 = 路由系統
  • 收件人 = 控制器/功能

分信員看到信件上的地址,就知道要把信送到哪裡。路由系統看到網址,就知道要執行哪個功能。


## 二、Laravel 路由的基本語法

最簡單的路由長這樣

打開 routes/web.php 檔案,你會看到類似這樣的程式碼:

Route::get('/', function () {
    return '歡迎來到我的網站!';
});

讓我們拆解這段程式碼:

部分 意思 比喻
Route::get() 處理 GET 請求 「有人想看東西」
'/' 網址路徑(首頁) 「大樓的 1 樓大廳」
function () { ... } 要執行的動作 「櫃檯人員的工作」
return '...' 回傳給使用者的內容 「給訪客的回應」

更多路由範例

// 首頁
Route::get('/', function () {
    return view('welcome');  // 顯示歡迎頁面
});

// 關於我們頁面
Route::get('/about', function () {
    return view('about');  // 顯示關於頁面
});

// 聯絡我們頁面
Route::get('/contact', function () {
    return view('contact');  // 顯示聯絡頁面
});

對應的網址:

  • http://你的網站.com/ → 首頁
  • http://你的網站.com/about → 關於我們
  • http://你的網站.com/contact → 聯絡我們

## 三、HTTP 方法:不只是「看」,還有「做」

🎬 想像你在餐廳點餐

在餐廳裡,你會做不同的動作:

動作 對應的 HTTP 方法 程式碼
看菜單 GET Route::get()
點餐 POST Route::post()
改訂單 PUT / PATCH Route::put()
取消訂單 DELETE Route::delete()

實際程式碼範例

// 看所有文章(GET = 獲取資料)
Route::get('/posts', function () {
    return '顯示所有文章列表';
});

用 Antigravity 開發時,怎麼同時開第 2、第 3 個視窗,並重新打開 Laravel 專案(餐廳比喻版)

用 Antigravity 開發:同時開第 2、第 3 個視窗,並重新打開 Laravel 專案(餐廳比喻版) 用 Antigravity 開發:同時開第 2、第 3 個視窗,並重新打開 Laravel 專案(...