從 Vue 跳到 React 的開發心得 — 兩個框架的差異與轉換經驗

我從 Vue 開始做前端,接觸 React 後重新適應 JSX、state 更新和 Effect,用程式碼對照兩邊的寫法與容易誤會的地方。

本篇目錄

我做前端是從 Vue 入門,後來工作上也接觸了 React 專案。換框架時,有些概念可以沿用,有些習慣得重新適應。以下整理我實際開發時感受到的差異。

為什麼要學 React

老實說,Vue 用得很順手,一開始我對學 React 沒有太大的動力。但後來有幾個現實的考量:

  1. 工作機會:當時我看的職缺裡,React 的需求比較多,也有不少外商職缺使用 React
  2. 生態系:React 的社群資源和第三方套件非常豐富
  3. 技術視野:多學一個框架可以用不同角度思考問題

Vue 和 React 都用元件拆分 UI,也都需要處理狀態與副作用。有 Vue 3 Composition API 的經驗,能幫助理解 React Hooks 的用途;不過,執行時機與更新方式仍要重新熟悉。

最明顯的差異:模板 vs JSX

Vue 用的是 template 語法,其實就是 HTML 加上 Vue 的指令(directives),長這樣:

<template>
  <div>
    <h1>{{ title }}</h1>
    <ul>
      <li v-for="item in items" :key="item.id">
        {{ item.name }}
      </li>
    </ul>
    <button @click="handleClick">點我</button>
  </div>
</template>

React 用的是 JSX,邏輯和 UI 混在一起:

function MyComponent() {
  return (
    <div>
      <h1>{title}</h1>
      <ul>
        {items.map((item) => (
          <li key={item.id}>{item.name}</li>
        ))}
      </ul>
      <button onClick={handleClick}>點我</button>
    </div>
  );
}

剛開始看 JSX 會覺得很亂,怎麼 HTML 跟 JavaScript 攪在一起。但寫久了發現,這種寫法其實很靈活,複雜的條件渲染反而比 v-if 直覺。

React 使用 JavaScript 搭配 JSX 描述 UI。它沒有 Vue 的模板指令(v-if、v-for、v-model),這些邏輯要用 JavaScript 來寫。因此,學 React 前需要熟悉 map、filter、三元運算子和解構賦值,寫 UI 時會經常用到。

狀態管理的差異

先用計數器對照兩邊的寫法:

Vue 3:

const count = ref(0);
const doubled = computed(() => count.value * 2);

const increment = () => {
  count.value++;
};

React:

const [count, setCount] = useState(0);
const doubled = useMemo(() => count * 2, [count]);

const increment = () => {
  setCount(count + 1);
};

Vue 的 ref 是響應式的,可以透過 .value = xxx 更新。React 的 useState 則要透過 setter 告知更新;物件和陣列應視為不可變資料,建立新值再交給 React。

從 Vue 轉過來,很容易沿用直接修改值的習慣。但在上面這個 const 宣告裡寫 count++,會先因為重新指定常數而拋出 TypeError。即使改用 let,修改某次 render 的區域變數,也不會替 React 排程 state 更新;計數器仍要透過 setCount 更新。

這裡的 computed 和 useMemo 都算出兩倍的值,但不能把它們當成完全相同的機制。Vue 的 computed 會追蹤響應式依賴;React 的 useMemo 是 render 期間的快取優化。像這種簡單乘法,直接計算通常就夠了,不必依賴快取才能維持程式正確。

生命週期的對應

Vue 的生命週期可以作為理解用途的入口,但下面是近似對照,並非一對一替換:

Vue 3 React 常見陷阱/心智模型落差
onMounted useEffect(() => {}, []) Vue 每次掛載時執行;React 在根節點啟用 StrictMode 的開發環境,會額外做一次 setup → cleanup → setup,檢查清理是否正確
onUpdated useEffect(() => {}) 注意:這個寫法沒有 dependency array,第一次 render(也就是 mount)也會先執行一次,和 Vue 的 onUpdated(明確不含初次掛載)並不對等
onUnmounted useEffect 的 cleanup function 容易忘記 cleanup,導致 event listener 重複綁定
watch useEffect 搭配 dependency array Vue 的 watch 預設不立即執行;React 的 Effect 在客戶端掛載後執行,也會在依賴改變後執行,不在伺服器渲染時執行

React 用 useEffect 處理副作用,我一開始不太習慣。後來理解 dependency array 如何影響重新執行的時機,才比較知道該怎麼安排這些邏輯。

詳細的生命週期對照與陷阱

我從 Vue 轉過來時,常把 useEffect 當成另一種 onMounted 或 onUpdated,後來才逐漸習慣依照依賴來安排同步。沒有 dependency array 的 Effect,在首次掛載後也會執行,所以不能直接拿來替換 onUpdated。

用 ref 標記「略過第一次」也不是通用解法:根節點啟用 StrictMode 的開發環境會額外執行 setup → cleanup → setup,第二次 setup 已經看得到改過的 ref。遇到這種需求,先確認操作是不是由按鈕或表單送出觸發;如果是,可以放在事件處理函式。若是同步外部系統,就依賴相關 state,並讓 setup 與 cleanup 能正確配對。StrictMode 額外執行 Effect正是為了協助找出這類問題。

最大的陷阱:Stale Closure

在 Vue 裡,透過同一個 ref 讀取 count.value,會取得它當下的值。React 的函式則會捕捉建立它的那次 render 所使用的變數;如果 Effect 使用了 count,卻沒有在依賴改變時重建,裡面的 callback 就可能一直讀到舊值。

// React 陷阱題
useEffect(() => {
  const timer = setInterval(() => {
    console.log(count); // 這裡的 count 永遠是初始值 0!
  }, 1000);
  return () => clearInterval(timer);
}, []); // 因為 dependency 是空的

這花了我一些時間適應。以前習慣透過 Vue 的響應式系統讀取最新值,換到 React 後,就得留意 closure 和依賴設定。

心智模型的轉變:Mutable vs Immutable

這應該是兩個框架最核心的差異。

Vue 的世界觀:你可以修改我,我會通知大家。 Vue 的 data 是 mutable 的。你想改標題?title.value = 'New'。Vue 的 Reactivity system 會攔截這個 setter,然後去更新畫面。這很直覺,跟我們平常直接修改 JS 物件的寫法一樣。

React 的世界觀:你不能修改我,你要創造一個新的我。 React 預期你把 state 當成 immutable 資料。要更新 title,就呼叫 setTitle('New'),讓 React 在下一次 render 使用新值。

這個差異也讓兩邊的寫法習慣跟著不同:

  • Vue: arr.push(item)(開心!)
  • React: setArr([...arr, item])(麻煩但安全)
  • Vue: obj.prop = 1
  • React: setObj({ ...obj, prop: 1 })

把 state 當成不可變資料處理,再透過 setXXX 更新,比較容易追蹤資料怎麼改變。不過 React 不會自動把所有物件凍結;如果仍直接修改原物件,就可能破壞這個約定。

Next.js vs Nuxt

如果要做 SSR,Vue 有 Nuxt,React 有 Next.js。兩個框架的概念很類似:

  • 檔案系統路由
  • 自動程式碼分割
  • SSR / SSG / ISR 支援
  • API Routes

用過 Nuxt 3 再學 Next.js,路由與資料載入的用途比較容易理解。不過,Server Component、快取和伺服器/瀏覽器的分工,仍要依 Next.js 的規則重新學,不能只把 API 名稱換掉。

資料抓取:

Nuxt 用 useFetch 或 useAsyncData:

const { data } = await useFetch("/api/posts");

Next.js 的 App Router 用 async component:

async function Page() {
  // Server Component 的 fetch 跑在伺服器上,沒有「目前網址」可以當基準,
  // 相對路徑會直接丟 TypeError,必須給絕對網址。
  const res = await fetch(`${process.env.API_BASE_URL}/api/posts`);
  const data = await res.json();
  return <div>{/* ... */}</div>;
}

這一點是從 Nuxt 過來最容易踩的坑:useFetch("/api/posts") 在 Nuxt 裡不管跑在伺服器還是瀏覽器都能正常運作,但 Next.js 的 Server Component 沒有這層包裝。

上面的寫法適用於 /api/posts 在外部後端的情況。如果它是同一個 Next.js 專案裡的 Route Handler,Server Component 應該直接呼叫讀取資料的函式(例如 const posts = await getPosts()),不要再透過 HTTP 打自己的 API。如果頁面在建置時預先渲染,打自己的 Route Handler 會讓建置失敗,因為建置期間沒有伺服器在監聽;隨請求渲染時,也會多一趟網路往返。

狀態管理工具

Vue 生態系用 Pinia,React 生態系選擇比較多:Redux、Zustand、Jotai、Recoil…

後記(2026 更新):Recoil 已於 2025 年初被 Meta 封存(archived),不再維護,新專案請不要再採用。文中提到的 Zustand、Jotai 都仍在活躍開發中。

我自己比較喜歡 Zustand,寫法簡潔,跟 Pinia 的感覺有點像:

// Zustand
const useStore = create((set) => ({
  count: 0,
  increment: () => set((state) => ({ count: state.count + 1 })),
}));

// 使用
const { count, increment } = useStore();

比起 Redux 的 action、reducer、dispatch 那一套,Zustand 直接多了。

轉換時遇到的坑

1. 忘記 Immutable

React 的狀態更新要保持 immutable,不能直接修改原物件:

// ❌ 錯誤
const handleClick = () => {
  items.push(newItem);
  setItems(items); // 不會觸發更新
};

// ✅ 正確
const handleClick = () => {
  setItems([...items, newItem]);
};

Vue 的響應式系統會幫你處理這些,React 要自己注意。

2. useEffect 的 Dependency Array

useEffect 的 dependency array 設錯,會造成無限迴圈或該更新的時候沒更新:

// ⚠️ 小心無限迴圈
useEffect(() => {
  setCount(count + 1);
}, [count]); // count 變了就執行,執行又改 count...

3. Conditional Hooks

React Hooks 不能放在條件式裡面:

// ❌ 錯誤
if (isLoggedIn) {
  const [user, setUser] = useState(null);
}

// ✅ 正確
const [user, setUser] = useState(null);
if (isLoggedIn) {
  // 使用 user
}

這個規則一開始會覺得很奇怪,但這是 React Hooks 的設計限制。

哪個比較好?

這個問題沒有標準答案。兩個框架都很成熟,都能做出好的產品。

Vue 的優點:

  • 學習曲線較平緩
  • 工具搭配方便:Vite 可用於多種框架,Pinia 和 Vue Router 則是 Vue 官方維護的狀態管理與路由工具
  • 模板語法對設計師比較友善

React 的優點:

  • 生態系更龐大
  • 我當時看的職缺中,使用 React 的工作機會較多
  • JSX 的靈活度更高
  • 社群資源豐富

我自己是兩個都用,看專案需求決定。已經有 Vue 基礎的人,學 React 不會太困難,反過來也是。

給想學 React 的 Vue 開發者

  1. 先學好 JavaScript:React 比較需要紮實的 JS 基礎,特別是 array methods、解構、spread operator

  2. 接受 JSX:一開始會不習慣,但寫久了會發現它的好

  3. 理解 Immutable:這是 React 的核心觀念,一定要搞懂

  4. 不要硬套 Vue 思維:有些東西在 Vue 很自然,在 React 要換一種方式思考

  5. 從 Next.js 開始也行:如果已經會 Nuxt,直接學 Next.js 會很有代入感,學得也快


站內相關文章: