Skip to main content

​
前言

在 Windows 上開發 Laravel 時，使用 WSL（Windows Subsystem for Linux） 是最佳實務。因為可以直接使用 Linux 的工具鏈，與 macOS 或正式伺服器相同的指令都可以執行。 本指南說明如何在 WSL 2 上的 Ubuntu 中安裝 PHP、Composer、Node.js（透過 nvm），並讓 laravel new 能正常運作。
適用環境：Windows 10（2004 版以後）或 Windows 11。使用 WSL 2。

​
安裝 WSL

1

以系統管理員身份開啟 PowerShell

在「開始」功能表搜尋「PowerShell」，選擇「以系統管理員身份執行」。
2

安裝 WSL 與 Ubuntu

此指令會安裝 WSL 2 與 Ubuntu（預設散布版）。完成後請重新開機。
3

設定 Ubuntu

重新開機後，Ubuntu 會自動啟動。請設定使用者名稱與密碼。此密碼會在 sudo 指令時使用。
密碼在輸入時不會顯示在畫面上。請正確輸入。
4

更新套件列表

在 Ubuntu 的終端機執行下列指令。

​
安裝 PHP

Ubuntu 標準 repository 的 PHP 可能包含舊版本。使用 ondrej/php PPA 安裝最新版本。
1

安裝必要套件

2

新增 ondrej/php PPA

3

安裝 PHP 8.3 與必要的擴充套件

Laravel 13 需要 PHP 8.3 以上。
4

確認版本

若顯示 PHP 8.3.x 以上即成功。
5

（選用）切換多個版本

若需要多個 PHP 版本，可用 update-alternatives 切換。
會顯示已安裝的版本清單，輸入要使用版本的編號。

​
安裝 Composer

Composer 使用官方 installer 安裝。
1

確認必要套件

2

下載並執行官方 installer

3

確認版本

4

設定全域安裝路徑

為了能使用透過 composer global require 安裝的套件（如 Laravel installer），將 ~/.composer/vendor/bin 加入 PATH。在 ~/.bashrc（或 ~/.zshrc）中加入以下內容。
套用設定。

​
安裝 nvm

Node.js 使用 nvm（Node Version Manager）以使用者單位安裝。因為可以在不需 sudo 下管理，與使用全域 npm 套件的 AI 工具或 CLI 相容性佳。
1

安裝 nvm

最新的安裝 script 可於 nvm 的 GitHub repository 確認。
2

加入 shell 設定檔

安裝 script 會自動在 ~/.bashrc 加入以下內容。若未加入請手動加入。
套用設定。
若使用 zsh，請以相同方式加入 ~/.zshrc，並用 source ~/.zshrc 套用。
3

確認安裝

​
安裝 Node.js

1

安裝 LTS 版本

2

設定為預設

為了讓新的終端 session 也自動使用，設定預設版本。
3

確認版本

​
Laravel 安裝確認

1

加入 Laravel installer

2

建立新專案

會啟動互動式設定。可選擇 starter kit 或是否啟用認證等。
3

啟動開發伺服器

在瀏覽器開啟 http://localhost:8000，若顯示 Laravel 歡迎頁面即完成。
若無法從 Windows 瀏覽器透過 WSL 存取 localhost，請嘗試以 php artisan serve --host=0.0.0.0 啟動。

​
補充：提升開發效率的工具

​
Windows Terminal

使用 Windows Terminal 可透過多個分頁一次管理 WSL、PowerShell、命令提示字元。可從 Microsoft Store 免費安裝。
  • 以分頁並行操作多個 shell
  • 可將 Ubuntu 的 shell 設為預設
  • 自由客製化字型與配色

​
VS Code Remote - WSL 擴充套件

使用 VS Code 的 Remote - WSL 擴充套件，可以從 Windows 的 VS Code 直接編輯 WSL 內的檔案。
初次執行時，VS Code server 會自動安裝到 WSL 內。之後可享有與原生同等的操作體驗進行開發。
最後修改於 2026年8月2日

相關主題

部落格博客使用 Homebrew 安裝 PHP、Composer、Node.js（macOS）安裝以 Vite 進行 asset bundling