筆者原本選用「avn」這個套件，但它真的已經年久失修了無法使用連結

STEP 1：建立兩個 Node.js 專案

在終端機複製貼上下方指令即可。

mkdir project-a
cd project-a
npm init -y
cd ..
mkdir project-b
cd project-b
npm init -y
cd ..

STEP 2：安裝特定的 Node.js 版本以供測試

尚未 nvm 安裝的讀者，可以先透過如下指令安裝，更新的版本請參考連結。

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.2/install.sh | bash

安裝完後建議重開終端機讓它生效，接著透過它安裝 Node.js 特定版本：

nvm install 12
nvm install 16

STEP 3：在兩個 Node.js 專案中加入「.nvmrc」並指定 Node.js 版本

接下來我們就分別在兩個專案中新增「.nvmrc」的檔案，並個別指定 12、16 版本方便測試（讀者在終端機複製貼上下方指令即可）。

cd project-a
touch .nvmrc
echo "12" >> .nvmrc
cd ..
cd project-b
touch .nvmrc
echo "16" >> .nvmrc
cd ..

筆者為了方便 Demo 而指定大版本，「.nvmrc」檔案是能吃「x.y.z」版本號的。

STEP 4：調整 zsh script

在終端機輸入 vi ~/.zshrc（每個人的路徑可能不同），到最後一行貼上下方 script：

# place this after nvm initialization!
autoload -U add-zsh-hook
load-nvmrc() {
  local node_version="$(nvm version)"
  local nvmrc_path="$(nvm_find_nvmrc)"
  if [ -n "$nvmrc_path" ]; then
    local nvmrc_node_version=$(nvm version "$(cat "${nvmrc_path}")")
    if [ "$nvmrc_node_version" = "N/A" ]; then
      nvm install
    elif [ "$nvmrc_node_version" != "$node_version" ]; then
      nvm use
    fi
  elif [ "$node_version" != "$(nvm version default)" ]; then
    echo "Reverting to nvm default version"
    nvm use default
  fi
}
add-zsh-hook chpwd load-nvmrc
load-nvmrc

儲存後再輸入 source ~/.zshrc 即可讓 script 生效。

這邊簡單說明 script 運行邏輯：

• 資料夾下有「.nvmrc」的檔案：若指定的 Node.js 版本已安裝就透過「nvm use」切換，假使該版本尚未安裝就會執行「nvm install」。
• 資料夾下沒有「.nvmrc」的檔案：切換回 Node.js 默認的版本。

唯一要注意的是，記得把這段 script 放在 nvm 初始化後的位置（或是直接放在最後面也可以）。

上面的 script 參考自 nvm 官網，如果讀者使用的是 bash script 請參考連結。

STEP 5：實測是否有效

筆者在開頭故意切換到 Node.js 18 的版本，然後再依序切換到「project-a」以及「project-b」的資料夾，從下圖大家可以看到 Node.js 的版本都順利切換嚕！

希望這篇文章，有幫大家解決不同專案的 Node.js 版本切換之苦～

如果你用上圖的錯誤訊息去 Google 搜尋，相信會得到很多解答；但這篇文章遇到的問題，如果用關鍵字搜尋是找不到真正解答的；也因為這次的經驗讓我對 Ubuntu Server、MySQL、apt-mark 有更深一層的認識。

大綱
ㄧ、問題描述
二、關鍵字搜尋到的方案
三、從 Error Log 猜想問題
四、問題的真實原因
五、解決方案
六、後記

ㄧ、問題描述

上週建立的中介資料庫在經歷一個假日後，在禮拜一被同事回報登入失敗。

一開始我以為是帳號密碼錯誤，又或是公司網路問題；但在成功登入 Server 後，我發現連 root 的權限都無法登入 MySQL DB，並出現如下錯誤：

ERROR 2002 (HY000): Can’t connect to local MySQL server through socket '/var/run/mysqld/mysqld.sock' (2)

二、關鍵字搜尋到的方案

遇事不知求 Google，我馬上搜尋過去前輩們是怎麼解決這個問題的。

解決的方法五花八門，我這邊統整一下大致的方向：

1. 重啟 MySQL 服務
2. 調整 MySQL 資料夾權限，補齊遺漏的檔案
3. 重啟整台 Server
4. 把 MySQL 砍掉重裝

但很遺憾的，1~3 我都嘗試過了，MySQL 依舊頑強的吐一樣的錯誤，看來不能依靠網路的的解法了。

三、從 Error Log 猜想問題

因為網路上的方案都失效，所以決定換一個問題處理的方向，去找 MySQL 的 Error Log（其實一開始應該就要這樣做）。

STEP 1：前往 MySQL 的設定檔。

sudo vim /etc/mysql/mysql.conf.d/mysqld.cnf

STEP 2：查看 Error Log 存放路徑。

STEP 3：查看 Error Log 內容。

sudo vim /var/log/mysql/error.log

從時間軸發現服務被完整的關閉後就無法重啟，但假日有誰會把服務給關閉呢？

於是我便詢問公司的 MIS 部門，在假日是否有對 Server 進行維護作業。

果然如我所料，對方表示在假日有對各 Server 系統做例行性維護升級，而這台 Ubuntu Server 的 MySQL 正是在這次升級後出問題。

四、問題的真實原因

既然問題是由系統升級引起的，那就比較有解決的方向了；在與 MIS 同仁討論後，我們猜想問題應該是 Ubuntu Server 升級後內建的 MySQL 版本為 8.0，但原本安裝的版本為 5.7，因此在升級後發生版本對應不到的問題。

於是我們便執行下面的指令來查看目前 apt 安裝的套件有哪些，以及對應的版本：

apt list --installed

結果如我們所想，系統更新後，新版本的 MySQL 真的把舊版本給覆蓋住了。

五、解決方案

但因為這台是給其他合作單位使用的資料庫，而對方因為總總歷史包袱只能選用 MySQL 5.7，所以我們是不能對它做升級的。

但幸好 MIS 在維護前有先將 Server 備份，因此我們如下步驟進行處理：

STEP 1：用備份將原本的 Ubuntu Server 還原。

STEP 2：下指令將 MySQL Server 版本鎖定。

apt-mark hold mysql-server

STEP 3：查看是否有鎖定成功。

apt-mark showhold

STEP 4：鎖定後再將 Ubuntu Server 做升級維護。

STEP 5：升級完成後確認 MySQL 版本有鎖定住。

mysql --version

透過上面的步驟後，MySQL 就成功復活了～

六、後記

這個問題花了不少時間才解決，主要是因為我在一開始判斷問題時就走偏了；過去我都是從錯誤訊息找答案，而這次的錯誤訊息卻把我引導到另一個錯誤的方向。

這次的經驗也讓我明白，除了發生問題的本體外，還要多觀察其他有「相依性」的資訊，否則會陷入死胡同，還期待用錯誤的方法得到正確的結果。

但同時也提醒大家，千萬不要看完這篇文章後，回去就把所有安裝的套件版本都鎖死；除非有不得已的理由，不然系統、套件都是需要定期更新的，這樣穩定性、安全性才足夠。

在你的成長的路上總有不少值得你警惕的前輩

為什麼寫這篇文章？

慘痛經驗 part 1

筆者曾待過超瞎的公司，他們對於一個專案遷移的概念還停留在把程式 copy 到 USB，到現場的時候再把他放到正式的server上面

所以每次發布新版本都超級心驚膽跳擔心會不會檔案沒有 call 完全(如果你曾經在 windows 上複製過 node_modules 超過 2G 的專案就會知道我在說什麼惹)、會不會到現場的 server 跑不動，這個詭異的問題直到我離開那間公司後才知道根本是一道假命題…

• 都用 git 了，為什麼還要把程式 call 到 USB？？？
• 都有 package.json 紀錄要安裝的套件跟版本了，我幹嘛要複製好幾G的套件進去 USB？？？
  不要笑，我相信現在還是有公司用這麼瞎的方式在發布新版本XD

慘痛經驗 part 2

筆者曾在公司兼職 MIS，幫公司架一個 gitlab 提供內部使用；但每個人 git 使用的習慣相差很大，有些部門的同事根本就沒在管什麼檔案適合傳到 gitlab 什麼不適合，每次 push 都全部上傳(各種執行檔、暫存檔全部上傳，根本把 gitlab 當成 NAS 在用…)

因為 git 版本控管的特性，他的專案在 gitlab 就越來越肥，儘管跟他溝通很多次這樣的 git 版控很有問題但都被當成耳邊風，直到有一天 gitlab 的硬碟終於被他用完了…(他一個專案就用了 15GB 的容量)，他才開始願意去了解自己專案中有多少檔案是不需要上傳的

PS.因為 gitlab 一般只會儲存程式碼，所以當時只劃分了 100GB 的硬碟空間

慘痛經驗 part 3

這個事件發生在一個熱愛技術的朋友身上，他使用了一個需要憑證的套件，這個憑證會根據使用者使用的次數去做收費，不知道他當時是喝多了還是太累了；他居然把憑證加入 git 版控上傳，我永遠記得下個月他收到帳單時臉上的表情有多麼的驚嚇

昨日經驗

昨天我們說到 .env 裡面存放的資料有許多都不適合公開(ex:資料庫帳號密碼、token…)，這些資料外流出去我想就不是檢討報告能解決的問題惹，為了避免誤傳檔案，今天我來介紹一個好用的東西 .gitignore，他是一份忽略清單，忽略清單上的都是不需要加入版本控制的檔案

今日目標

1. 了解哪些檔案/資料夾不需要放入版控
2. 在專案加入 .gitignore
3. 透過 VSCode 知道是否成功將檔案加入忽略清單
4. 為環境變數加上一個可以上傳的範例檔

1. 哪些檔案/資料夾不需要放入版控?

有了上方慘痛經驗的範例，我想大家應該對要加入 .gitignore 的檔案/資料夾有基礎概念了，在這我也整理了常見在忽略清單如下：

1. 機敏性資料：資料庫帳號密碼、存取權限的權杖(token)、憑證(credentials)…
2. 環境變數：專案env檔(因為裡面通常存有ip、password…等隱私資訊)
3. 套件資料夾：node_module、vendor…
4. 日誌檔案：log相關紀錄
5. 程式編譯時產生的檔案：快取檔案、暫存檔案、編譯結果

透過這份清單，大家可以想一下昨天的專案有哪些檔案/資料夾是要加入這份忽略清單的呢

2. 在專案加入.gitignore

1. 上一篇有提到我們這次的爬蟲會用到 FB & IG 的帳號密碼還有你 google sheet 的 id，這些資訊我們統一設定在 .env 環境變數裡面，我相信大家都不希望把這些機敏資訊放到 git 外流出去
2. 另外我們 透過 yarn 安裝的 dotenv 套件也產生了一個 node_modules 的資料夾，從經以後你所安裝的套件都會儲存到這個資料夾裡面，通常一個中型專案套件他的大小都高達 300MB 以上，所以這個 node_modules 的資料夾是不適合上傳到到 git 的(這些套件到新環境下指令yarn就能安裝)

所以我們的忽略清單會長這樣

.gitignore

node_modules
.env

3. 透過 VSCode 知道是否成功將檔案加入忽略清單

如果你也是用 VSCode 當成編輯器，可以用他觀察使用 .gitignore 的前後變化

• 使用 .gitignore 前： .env 及 node_modules 會被列入變更；綠色的字代表有新增(U)的檔案，棕色的字代表有改變(M)的檔案

  

• 在 SOURCE CONTROL 中可以看到有哪些檔案被列入變更

  

• 使用 .gitignore 後： .env 及 node_modules 會變成淺灰色，代表不會被列入變更

  

這份忽略清單會隨著你專案的變動而調整，如果你在撰寫其他種類程式語言可以參考github的官網來調整自己的.gitignore

4. 為環境變數加上一個可以上傳的範例檔

今天我們把 .env 放入 .gitignore 中讓他不會加入版控，但為了讓專案快速遷移，我會建立一個 .env.example 的檔案，他是環境變數的範例檔，這樣你在新環境只需要將他複製一份到 .env 檔填上自己的參數就能完成環境設定了，下面是本專案未來會用到的環境變數

.env.exmaple

#填寫你目標放入的sheet id
SPREADSHEET_ID='your sheet id'

#你FB及IG的帳號密碼(建議用小帳號)
IG_USERNAME='ig username'
IG_PASSWORD='ig password'
FB_USERNAME='fb username'
FB_PASSWORD='fb password'

#這是設定排程的時間參數(目前預設每日22:30準時執行)
CRONJOB_TIME='0 30 22 * * *'

⏭️ 下個階段

關於撰寫程式的基礎介紹就到今天，從明天會開始撰寫爬蟲，這裡先跟各位分享一下我對於功能撰寫順序的邏輯以及技術文章未來的規劃

• 判斷哪個功能需要最先研究
  1. 我們先前列出很多功能項目，我個人對於研究的前後順序是先把不熟悉的完成，因為他通常會花你最多時間
  2. 如果中間有遇到無法解決的問題，最慘的結果就是你必須放棄這個專案，所以我建議不熟悉的東西你最好再接案前要做一下功課確認是可以完成的，這就是你從最難的部分開始實作的好處：及時止損，避免你完成大部分功能最後因為卡在一個關鍵功能無法完成交付
• 專案撰寫順序
  我會按照我當時撰寫的思路完整的呈現給大家，目前的順序是：
  • 爬蟲功能 → 儲存到雲端Google Sheets → 電腦自動排程執行 → LINE通知提醒執行結果

ℹ️ 專案原始碼

今天的完整程式碼可以在這裡找到喔

在許多人的幫助下，本系列文章已出版成書，並添加了新的篇章與細節補充：

• 加入更多實務經驗，用完整的開發流程讓讀者了解專案每個階段要注意的事項
• 將爬蟲的步驟與技巧做更詳細的說明，讓讀者可以輕鬆入門
• 調整專案架構
  • 優化爬蟲程式，以更廣的視角來擷取網頁資訊
  • 增加資料驗證、錯誤通知等功能，讓爬蟲執行遇到問題時可以第一時間通知使用者
  • 排程部分改用 node-schedule & pm2 的組合，讓讀者可以輕鬆管理專案程序並獲得更精確的 log 資訊

有興趣的朋友可以到天瓏書局選購，感謝大家的支持。

購書連結：https://www.tenlong.com.tw/products/9789864348008

如果屠龍刀是系統贈送的武器，你為什麼要自己打造一個破鐵刀?

為什麼寫這篇文章？

我周圍有些人在面對需求時很喜歡寫一些市面上已經提供的套件而不是直接使用它，而且他們寫出來的套件 bug 通常比原版多很多…

以個人的開發經驗來說，有 97% 以上的套件我是看過說明文檔就去使用，只有 3% 會去看這份套件到底怎麼寫，會去看他怎麼寫的套件通常不是因為他寫的太好，而是他寫的很爛，因為 bug 影響到功能導致使用者需要去修正或者評估使用其他解法

請不要重複造輪子，人類的進步，大部分是繼承前人的知識繼續發展

EX：你需要了解怎麼使用電腦，但你不需要買材料自己做出一台電腦

這篇文章除了套件安裝跟版控外，我還能學到什麼?

我們身處在一個開源工具大爆炸的時代，每天都有無數個程式大神寫好套件公開在網路平台供大家使用，所以當我們想要做某些功能的時候我們可以先找找看有沒有好心的前輩們幫我們完成這些功能了

但同時正因為開源工具爆炸，我們面對的不是沒有工具而是工具太多不知道怎麼選，所以在了解套件的重要性後，更重要的是知道如何找出適合的套件

今日目標

1. 了解套件對專案幫助有多大
2. 如何找出適合的套件
3. 學會安裝套件，觀察安裝後目錄結構的變化
4. 學會控制套件版本範圍
5. 知道如何下關鍵字找工具

1. 套件對專案的幫助

身為一個工程師，比起撰寫一個新功能，我更多的時間在研究如何使用一個套件，下面舉例說明套件對於專案的幫助：

1. 能夠快速評估專案功能的可行性
2. 可以更準確預估每個功能的完成時間
3. 節省大量自己重頭寫功能的時間
4. 你可以更專心地維護自己寫的程式邏輯
5. 避免專案主程式肥大

2. 如何找出適合的套件

由於套件的資源實在是太多了，不管是大神還是新手都可以發布套件，這造成了套件本身的良莠不齊，我這裡提供幾個幫助你判斷套件是否符合需求以及套件品質的方法：

1. 我會先用下面幾個最基礎的指標來做判斷
   • 套件最後發布時間：太久沒維護的套件請謹慎選用
   • 每週下載次數：越多人下載的套件穩定性越高
   • 版本：一般來說 1.0.0 以前的版本通常穩定性上有疑慮，盡可能避免使用
2. 有時候你需要的功能有很多個套件可以完成，這時上面的指標便可成為我們選用的依據

   • 我們在提供 npm 套件的網頁搜尋 env 就出現了高達149頁的套件資源

     

   • 我們點開前兩個套件：env、dotenv來做比較，你就很清楚選哪個是比較有保障的了

     套件	env	dotenv
     最後發布時間	9 years ago	10 months ago
     每週下載次數	2,171	11,326,358
     版本	0.0.2	8.2.0

     

     

3. 你同時要關心該套件的 issues 數量，如果太多建議你點進去看看 open issues，因為有些套件很久沒維護了

   • 點擊 issues 的數字便可跳到 github 的頁面來看 open issues 與 closed issues 的數量

     

     

4. 先透過閱讀套件的文件來確認是否有你想要的功能

   • 通常在 npm 網頁裡面就會有套件的說明，但部分套件因為使用上相對複雜，詳細的使用方法會放在 Homepage 的連結，點擊後會導向更詳細的說明文件(也可能是套件官網)

     

     

5. 大部分的套件都有提供 sample code，建議把套件加入專案前先用 sample code 測試來確認這個套件是否符合你的需求

3. 安裝套件，觀察安裝後目錄結構的變化

在這裡我們以明天要講的主題 環境變數 為範例，在 Node.js 專案要讀取 .env 的資料需要安裝一個 dotenv 的套件來抓 .env 的資料，安裝套件時請輸入指令

yarn add dotenv

安裝完後你會發現專案目錄下多了一些東西

• node_modules 資料夾：他會儲存你所安裝的套件

• yarn.lock 檔案：為了保證在不同機器上能得到一樣的結果，所以需要這個檔案儲存每個相依性所安裝的確切的版本

  

• 同時 package.json 檔案內容也有變化

  • 你會發現在 dependencies 中多了你剛剛安裝的套件 dotenv 版本為 "^8.2.0"

    

4. 套件不是安裝完就沒事了，你得學會控制套件版本範圍

因為部分套件有版本相依性，所以你需要學會如何控制套件的版本，常見狀況如下：

• 套件更新到最新版本後壞掉是常有的事
• 有些套件甚至是在某個框架下只有某幾個版本能用

所以我們需要了解如何透過版號控制專案下的套件版本

1. 控制 package.json 裡面套件的版本
   版本格式：主版號.次版號.修訂號
   • 1.0.0.
     • 指定版本，限定只使用 1.0.0 版本
   • ^1.0.0
     • 可使用 >=1.0.0 且 <(1+1).0.0 的版本
     • 範例：
       • ^1.2.3 版本範圍 >=1.2.3 <2.0.0
       • ^0.2.3 版本範圍 >=0.2.3 <0.3.0
   • latest
     • 當前發布的版本，使用 npm install 所安裝的套件就是標記 latest 的版本
   • ~0.1.1
     • 可使用 >=0.1.1 且 <0.(1+1).0 的版本
     • 範例：
       • ~1.2.3 版本範圍 >=1.2.3 <1.3.0
       • ~0.2 版本範圍 >=0.2.0 <0.3.0
   • git://github.com/user/project.git#commit-ish
     • 直接使用 Git URL 的套件
2. 練習控制套件版本
   1. 打開專案 package.json，調整套件版本
   2. 在專案資料夾的終端機(Terminal)執行指令 yarn 安裝套件
   3. 在 yarn.lock 檔案觀察下載的套件版本是否正確

5. 如何下關鍵字找工具

我個人的找資料的方向是：

• 查官方資源提供的方法：因為通常資料及提供的方法最齊全
• 看網路資源：是否有前輩做過相同的事情並提供範例
• 查詢 npm 套件：有人已經將他的經驗無私的打包成套件讓大家直接使用了

在這我以本次的專案功能為例，我是以下面這些關鍵字來找需要的資源，通常用英文搜尋比較容易找到：

1. FB、IG爬蟲
   • 官方資源：FB api、IG api
   • 網路經驗：FB crawler、IG crawler
   • 換成更廣義的方式找工具：網頁爬蟲、web crawler
2. excel處理
   • 官方資源：excel api、google sheet api
   • 套件資源：excel npm、google sheet npm
3. 排程
   • 套件資源：cron npm
4. LINE通知
   • 官方資源：LINE api
   • 套件資源：LINE npm

基本上靠著這些關鍵字就能找出你所需要的資源了，我會先測試過些工具提供的 sample code 符合我的需求後才會正式接案，雖然多花了一份工，但卻可以保證你結案的穩定性；歡迎大家在下方留言分享自己找工具的方法喔～

參考資源

1. yarn.lock
2. package.json 套件版本控制
3. npm-semver

在許多人的幫助下，本系列文章已出版成書，並添加了新的篇章與細節補充：

• 加入更多實務經驗，用完整的開發流程讓讀者了解專案每個階段要注意的事項
• 將爬蟲的步驟與技巧做更詳細的說明，讓讀者可以輕鬆入門
• 調整專案架構
  • 優化爬蟲程式，以更廣的視角來擷取網頁資訊
  • 增加資料驗證、錯誤通知等功能，讓爬蟲執行遇到問題時可以第一時間通知使用者
  • 排程部分改用 node-schedule & pm2 的組合，讓讀者可以輕鬆管理專案程序並獲得更精確的 log 資訊

有興趣的朋友可以到天瓏書局選購，感謝大家的支持。

購書連結：https://www.tenlong.com.tw/products/9789864348008