後端一行不動，若依先換了一張臉：那套叫 ruoyi-vue-nys 的前端，把「另起爐竈」這條路堵上了

2026 年 10 月 5 日，掘金作者 niyongsheng 發布了專案 ruoyi-vue-nys。一句話講完它要做的事：後端零改動，前端整套替換。若依（RuoYi）的後端 API 原封不動，前端卻從上一代的技術審美，整個跳到 Vue 3.5、Vite 與 TypeScript 5.9 的世界。

這篇文章在掘金社羣流傳，圍觀的多是常年跟後臺管理系統打交道的前端工程師。它戳中的痛點很具體，也很有畫面感。

若依的處境：起手式很順手，長相卻停在上一代

先補一點背景。若依大概是中文圈最受歡迎的開源後臺管理框架之一，RBAC 權限體系完整、文件與社羣成熟，RuoYi-Vue 幾乎成了「後臺管理系統」的預設起手式。

但官方前端多年停留在舊世代的觀感。作者在文中列出的問題包含：主題定制能力弱，換個主色要改一堆 Less 變數、布局單一、沒有國際化。

於是很多團隊的真實狀態變成：後端繼續用若依，前端自己重寫一遍。代價是權限、字典、代碼生成這些能力全部要重新對接一次。

零改動的代價：把「方言」一個個掛回去

要做到「50 餘個頁面零改動遷移」，關鍵不是把頁面搬過去，而是把若依的「方言」在新技術棧上重新實作一遍。

若依的頁面裡充滿自己的慣用寫法：res.rows、this.download、this.$modal、v-hasPermi 指令。這些都是原本框架注入的全域方法與約定，頁面程式碼直接依賴它們。

ruoyi-vue-nys 的做法是在 src/plugins/ruoyi.ts 裡集中把這些全域能力掛回去，包含 useDict、download、parseTime、resetForm、handleTree、addDateRange 等等。作者統計，這類呼叫點超過 250 個。也就是說，舊頁面拷貝過來就能跑，跑在下面的其實是一套被重新鋪好的地基。

這種「舊介面、新引擎」的做法，和先前掘金那篇 Electron 41 加 React 19 的模板文受到圍觀的邏輯有點像：開發者愛看的從來不是炫技，是「我明天上班能不能直接用」。

技術棧長什麼樣

專案結構用 pnpm workspace 管理，內建 5 個 @sa/* 套件：color（色板生成）、hooks、materials、utils、uno-preset。主題、布局與路由約定等基礎架構，作者也註明參考了同為開源的 soybean-admin 體系。

其他選項：UI 用 Element Plus 2.14 搭 UnoCSS，狀態與路由交給 Pinia 和 vue-router，國際化用 vue-i18n 支援中英切換，圖表是 ECharts 6，工程面配 ESLint 9 與 vue-tsc。

效果面：主題抽屜、暗色模式、i18n 一鍵切換

從文中的截圖來看，替換後的成果包含幾個面向。亮色主題附帶一個主題配置抽屜，主題模式、布局模式、主題色與頁面功能可以在同一個畫面調整；暗色模式加英文介面靠 i18n 一鍵切換；用戶管理頁不論亮暗，組織機構樹、搜尋表單、分頁與行內操作都齊全；ECharts 監控圖表也能自動跟隨主題變色。

換句話說，這不只是換膚，是把若依多年缺的主題系統、布局彈性與國際化一次補齊。

圍觀的人在看什麼

這類文章的看點，其實在「零改動」三個字。後臺系統最怕的就是遷移，頁面一多，改一個全域方法就要動幾十個檔案。把 250 多個呼叫點在新框架裡重新接好，讓舊頁面原樣可用，這個工程量本身就是話題。

至於值不值得用，取決於各團隊對若依的依賴深度。但至少「後端用若依、前端只能重寫」這個二選一，現在多了一條中間路：後端不動，前端整層換掉，舊頁面照跑。對被舊後臺觀感折磨過的開發者來說，這個選項本身就足夠讓人停下來看兩眼。