「明明都是十分得力的開發工具，卻發生衝突，無法裝在一起？」
（圖片來源：使用 AI 技術生成）
不知道您是否曾遇過這樣的問題：好不容易發現一個超實用的 Node.js 工具，正打算將其全域安裝，卻意外跳出錯誤訊息——錯誤：執行檔已存在，請先刪除既有檔案後重試。
這通常是因為兩個工具採用相同的指令名稱，彼此發生衝突，所以不讓您將它們同時安裝在系統裏！
Netlify CLI（netlify-cli）和 Node Task List（ntl）就是我遇過的其中一對，兩套工具都想佔用 ntl 這指令，迫使我不得不在它們中二選一。
對於在 Netlify 上部署專案的網頁開發者而言，Netlify CLI 可說是必備神器：它能協助您管理部署流程、設定網站參數、進行除錯。另一方面，Node Task List（NTL）則是我相當喜愛的 Node.js 小工具，能自動將 package.json 中的腳本指令（例如 npm run dev、npm run build）變成互動式選單，大大省卻了手動輸入指令的麻煩。對於常常忘記指令細節的開發者來說，絕對是必備的神器。
然而，當我嘗試將這兩款工具同時安裝到系統中，執行 npm install -g 命令時卻收到錯誤訊息，顯示兩者無法共存！在 Linux 環境中，此問題尚可藉由加上 --force 參數強制安裝以解決衝突；但在採用 Volta 管理 Node 版本的 Windows 平台上，情況則格外棘手。由於 --force 參數在此環境下無法奏效，而官方文件亦未提供任何解決方案。當時我真是苦惱不已——難道真得必須在 NTL 與 Netlify CLI 之間做出無奈的抉擇？
後來我發現，只要摸透 Volta 的設定邏輯，動一下手腳就能讓兩套工具和諧共存。本文將完整分享我的解決方案——手動修改 Volta 註冊表。跟著下列步驟做，就能同時全域安裝存在「撞名」指令的工具，再也不用陷入「安裝Ａ就必須刪除 Ｂ」的矛盾局面。
（血淚心得：如果早就有人告訴我可以這樣做，有多好啊！）
常見錯誤
Linux 搭配 NVM 的情況
以下是一個使用 NVM 管理 Node 版本時，在已安裝 Netlify CLI 的狀況下，安裝 NTL（ntl）會遇到的錯誤訊息：
# Linux 終端機
$ npm install -g ntl
npm error code EEXIST
npm error path /home/user/.nvm/versions/node/v20.17.0/bin/ntl
npm error EEXIST: file already exists
npm error File exists: /home/user/.nvm/versions/node/v20.17.0/bin/ntl
npm error Remove the existing file and try again, or run npm
npm error with --force to overwrite files recklessly.
對於以 NVM 管理 Node 的用戶來說，解決辦法相對簡單：在全域安裝 ntl 時利用 --force 參數強制安裝，以覆蓋衝突的執行檔即可。
Windows 搭配 Volta 的情況
在 Windows 上使用 Volta 管理 Node 時，情況卻複雜不少：
# PowerShell
$ npm install -g ntl --force
Volta error: Executable 'ntl' is already installed by netlify-cli
Please remove netlify-cli before installing ntl
習慣使用 Volta 的 Windows 用戶會發現，Volta 嚴格禁止執行檔名稱重覆，即使加上 --force 參數，也無法強制覆蓋衝突檔案。
接下來，我將逐步說明如何在 Windows 系統中，讓這兩套工具和平共存，並完美地發揮各自功能。
解決衝突的步驟
1. 解除安裝發生衝突的套件
若已安裝 NTL 或 Netlify CLI，請先清除可能殘留的衝突檔案：
npm uninstall -g ntl
npm uninstall -g netlify-cli
2. 重新安裝 Netlify CLI
首先，請全域安裝 Netlify CLI，此時系統會自動註冊 ntl 指令，並綁定為 netlify 指令的別名：
npm install -g netlify-cli3. 確認 Netlify CLI 安裝路徑
您可以執行 volta which ntl 指令，檢查 ntl 的實際所在路徑。其輸出結果應類似：
C:\Users\<使用者名稱>\AppData\Local\Volta\tools\image\packages\netlify-cli\ntl
4. 刪除 Volta 安裝路徑中的衝突檔案
使用檔案總管，前往下列路徑：
C:\Users\<使用者名稱>\AppData\Local\Volta\tools\user\bins\
在 bins 資料夾中，找出並刪除 ntl.json 檔案。此舉將移除 Volta 對 ntl 指令的既有綁定。
5. 重新安裝 Node Task List
接著，請重新全域安裝 NTL：
npm install -g ntl這一次，Volta 將不再彈出任何錯誤訊息，並順利將兩款工具成功安裝到系統中。
6. 確認兩套工具獨立運作
分別執行以下指令以檢查各自的安裝路徑：
volta which ntl
volta which netlify
輸出結果應指向不同的位置，應類似：
- Node Task List：
...\Volta\tools\image\packages\ntl\ntl - Netlify CLI：
...\Volta\tools\image\packages\netlify-cli\netlify
完成以上步驟後，您就能分別使用 ntl 指令來啟動 NTL 功能，以及用 netlify 指令調用 Netlify CLI，且兩者互不干擾！
結語
透過本文介紹的方法，您將能成功解決 Windows 系統搭配 Volta 時，NTL 與 Netlify CLI 的執行檔名稱衝突問題，讓您無需在工具選擇間妥協。無論是部署 Netlify 專案或管理 npm 腳本，都能流暢切換工具，提升開發效率。
希望這篇文章能為遇到此問題的開發者提供實用解決方案，歡迎在文章下方留言交流！
若想了解更多實用技巧，記得按❤️支持並追蹤我的沙龍！
本文改寫自：
