練習 - 設定 package.json

4 分鐘

您是 Tailwind Traders 的 Node.js 開發人員。了解如何設定新的 Node.js 專案是一個重要的技能。安裝套裝程式括產生 package.json 檔案，以及建立一些通用腳本，以在整個專案生命週期中使用。

在開發容器中開啟專案

已為您提供簡單的開發環境。如果您已在電腦上安裝 Node.js LTS，您可以略過本節並複製範例存放庫，並使用本機環境。

遠端開發 (瀏覽器)
本機開發 (Docker)

開始在 MicrosoftDocs/node-essentials GitHub 存放庫分的 main 分支上建立新的 GitHub Codespace 的流程。

在 GitHub Codespaces 中開啟此專案
在 [建立 Codespace] 頁面上，檢閱 Codespace 組態設定，然後選取 [建立新的 Codespace]
等候 Codespace 開始。此啟動程序可能需要幾分鐘的時間。
在 Codespace 中開啟新的終端機。

提示

您可以使用主功能表瀏覽至 [終端機] 功能表選項，然後選取 [新終端機] 選項。
驗證您的環境中已安裝 Node.js：
```
node --version
```
開發容器會使用 Node.js LTS 版本，例如 v20.5.1。確切的版本可能不同。
此專案中的其餘練習會在此開發容器的內容中進行。

在空白目錄的內容中開啟 Visual Studio Code。
請確定已在 Visual Studio Code 中安裝 Dev Containers 延伸模組。
在編輯器中開啟新的終端機。

提示

您可以使用主功能表瀏覽至 [終端機] 功能表選項，然後選取 [新終端機] 選項。
將 MicrosoftDocs/node-essentials GitHub 存放庫複製到目前的目錄。
```
git clone https://github.com/MicrosoftDocs/node-essentials.git
```
使用終端機中的下列命令，在程式碼中開啟存放庫。
```
cd node-essentials
code .
```
開啟 [命令選擇區]，搜尋 [開發容器] 命令，然後選取 [開發容器: 在容器中重新開啟]。

提示

Visual Studio Code 可能會自動提示您在開發容器內重新開啟現有的資料夾。這在功能上相當於使用命令選擇區重新開啟容器中的目前工作區。
驗證您的環境中已安裝 Node.js：
```
node --version
```
開發容器會使用 Node.js LTS 版本，例如 v20.5.1。確切的版本可能不同。
此專案中的其餘練習會在此開發容器的內容中進行。

設定新的 Node.js 專案

在此單元中，已為您提供 JavaScript 原始程式碼。您的作業是建立 package.json 檔案。

在終端機中，變更為此練習的資料夾：
```
cd node-dependencies/3-exercise-package-json
```
檢視資料夾的內容：
```
ls -R
```
在此資料夾中，您應該會看到含有 index.js 檔案的 src 子資料夾：
```
 ./src:
     index.js
```

執行下列命令以建立具有預設值的 package.json 檔案：

npm init -y

與下列範例類似的 package.json 檔案：

{
  "name": "3-exercise-package-json",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "keywords": [],
  "author": "",
  "license": "ISC"
}

package.json使用下列屬性值修改：

name："tailwind-trader-api"
description："HTTP API to manage items from the Tailwind Traders database"
main："index.js"
keywords：[「API」，「database」]
author："Sam"

您的 package.json 檔案現在看起來應該像下列程式碼：

{
  "name": "tailwind-trader-api",
  "version": "1.0.0",
  "description": "HTTP API to manage items from the Tailwind Traders database",
  "main": "index.js",
  "dependencies": {},
  "devDependencies": {},
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "keywords": ["api", "database"],
  "author": "Sam",
  "license": "ISC"
}

在區 scripts 段中，在腳本上方 test 新增名為 start 的新腳本：
```
"start": "node ./src/index.js",
```
儲存變更並關閉 package.json 檔案。
輸入此命令以 start 動作開始您的專案：
```
npm start
```
您應該會看見下列輸出：
```
Welcome to this application
```

您現在有一個良好的 package.json 檔案，您可以在專案成長時加以建置。

繼續

練習 - 設定 package.json

在開發容器中開啟專案

設定新的 Node.js 專案

意見反應