建立一個專案
從零開始設定真實的 Node.js 專案
⏱ 預估 ~9 分鐘
01 · 讀一讀
你用過的每個軟體 — 從手機 app 到超大網站 — 都是這樣開始的:有人建一個空資料夾、在裡面設定一個專案。你接下來就要做這個。
一開始就好好設定專案,可以省下後面一堆麻煩。Node.js 裡的專案不是什麼特別的東西 — 就是一個有 package.json 設定檔的資料夾,追蹤你專案的名稱、版本、相依套件。沒有這個檔,像 npm 這種工具根本不知道你的專案需要什麼或怎麼跑。
想成搬進新公寓。能裝潢或請朋友來之前,你要先簽租約、拿鑰匙。npm init 就是簽租約 — 它建立官方文件(package.json),表示「這個資料夾是真實專案」。
💡 想像一下開始一個專案就像搬進新公寓。你能裝潢或蓋什麼之前,要先簽租約(npm init)、拿到讓它生效的官方文件(package.json)。
重點整理
- 每個 Node.js 專案都從一個資料夾跟 package.json 開始
- package.json 追蹤專案的身分跟相依套件
- 一開始就正確設定,專案長大時不會混亂
02 · 真機練習
每個專案都從資料夾開始。建一個叫 my-server 的,然後進去。這兩個指令建立目錄、切換進去。
mkdir my-server && cd my-server
03 · 真機練習
現在用 npm 初始化你的專案。-y 旗標表示「全部用預設」 — 跳過問答、直接建立設定檔。
npm init -y
04 · 選擇題
npm init -y 裡的 -y 旗標做什麼?
- 安裝最新版 npm
- 建立 yarn.lock 檔
- 跳過所有問題、用預設
- Yes,刪掉現有檔案
05 · 真機練習
我們看 npm 建了什麼。package.json 是每個 Node.js 專案的心臟 — 它描述你的專案、追蹤相依套件。
cat package.json
06 · 填空
追蹤你專案相依套件的檔案叫 _____。
07 · 讀一讀
package.json 裡每個欄位的意思:- name — 你的專案名稱(預設是資料夾名稱) - version — 專案版本號(從 1.0.0 開始) - description — 專案在做什麼的簡短說明 - main — 入口點檔案(別人 import 你的專案時跑哪個檔) - scripts — 自訂指令,可以用 npm run <name> 跑 - keywords — 你發布到 npm 時的搜尋標籤 - license — 別人怎麼用你的程式碼
等下你會用到最重要的欄位是 dependencies — 它會列出你專案需要的每個套件。現在是空的,因為我們還沒裝任何東西。
重點整理
- package.json 是每個 Node.js 專案的設定檔
- npm init -y 用合理的預設建立它
- dependencies 欄位追蹤你專案用哪些套件
08 · 選擇題
你嘗試跑 npm install express,但出錯說沒有 package.json。你要先做什麼?
- 再裝一次 Node.js
- 手動建一個叫 express.js 的檔案
- 改跑 node install express
- 跑 npm init -y 建立 package.json 檔
⚠ 完整互動體驗需要 JavaScript。請啟用 JavaScript 後重新整理。
※ 本站為獨立繁中教學專案,非 Anthropic 官方產品。Claude™ 為 Anthropic, PBC 商標。