## 腳本 ### Nest CLI和 scripts 本節提供有關 `nest`命令如何與編譯器和腳本交互以幫助 `DevOps` 人員管理開發環境的其他背景。 Nest應用程序是標準的 `TypeScript` 應用程序，需要先將其編譯為 `JavaScript` 才能執行。有多種方法可以完成編譯步驟，并且開發人員/團隊可以自由選擇最適合他們的方法。考慮到這一點，`Nest` 提供了一系列開箱即用的工具，它們旨在執行以下操作： - 提供在命令行上可用的標準構建/執行過程，該過程“合理”且具有合理的默認值。 - 確保構建/執行過程是開放的，以便開發人員可以直接訪問基礎工具以使用本機功能和選項對其進行自定義。 - 保留一個完全標準的 `TypeScript` / `Node.js` 框架，以便可以由開發團隊選擇使用的任何外部工具來管理整個編譯/部署/執行。 通過結合使用 `nest` 命令，本地安裝的 `TypeScript` 編譯器和 `package.json` 腳本來實現此目標。我們在下面描述這些技術如何協同工作。這應該有助于您了解在構建/執行過程的每個步驟中發生了什么，以及在必要時如何自定義該行為。 ### Nest 二進制 `nest` 命令是操作系統級別的二進制文件（即從OS命令行運行）。 該命令實際上包含3個不同的區域，如下所述。 我們建議您通過包運行構建( `nest build` )和執行( `nest start` )子命令。當一個項目被搭建時，會自動提供 `json` 腳本如果您希望通過克隆倉庫而不是運行倉庫來啟動，請參見 [typescript starter](https://github.com/nestjs/typescript-starter))。 ### Build `nest build` 是標準 `tsc` 編譯器(用于標準項目)或 `webpack` 編譯器(用于 `monorepos` )之上的包裝器。它不添加任何其他編譯特性或步驟。它存在的原因是，大多數開發人員，特別是在開始使用 `Nest` 時，不需要調整編譯器選項(（例如 `tsconfig.json` 文件）。 有關更多細節，請參見 `nest build`文檔。 ### Execution `nest start` 只是確保已構建項目（與 `nest build` 相同），然后以可移植，簡單的方式調用 `node` 命令以執行已編譯的應用程序。 與構建一樣，您可以根據需要自由定制此過程，可以使用 `nest start` 命令及其選項，也可以完全替換它。 整個過程是標準的 `TypeScript` 應用程序構建和執行管道，您可以自由地管理過程。 有關更多詳細信息，請參見 `nest start` 文檔。 ### Generation `nest` 生成命令，顧名思義，生成新的 `nest` 項目或其中的組件。 ### Package scripts 在 `OS` 命令級別運行 `nest` 命令需要全局安裝 `nest` 二進制文件。這是 `npm` 的標準特性，不受 `Nest` 的直接控制。這樣做的一個后果是，全局安裝的 `nest` 二進制文件在 `package.json` 中沒有作為項目依賴項進行管理。例如，兩個不同的開發人員可以運行兩個不同版本的 `nest` 二進制代碼。對此的標準解決方案是使用 `Package` 腳本，以便您可以將構建中使用的工具和執行步驟視為開發依賴項。 運行 `nest new` 或克隆 `typescript starter` 時，`nest` 將填充新項目的包。`Nest` 使用諸如 `build` 和 `start` 之類的命令填充新項目的 `package.json` 腳本。 它還將基礎編譯器工具（例如 `Typescript` ）安裝為 `dev` 依賴項。 你運行構建和執行腳本的命令如下: ```bash $ npm run build ``` 和 ```bash $ npm run start ``` 這些命令使用 `npm` 的腳本運行功能來執行 `nest` 構建，或者使用本地安裝的 `nest` 二進制文件啟動 `nest`。通過使用這些內置的包腳本，您可以對 `Nest CLI` 命令*進行完全的依賴管理。這意味著，通過遵循建議的用法，可以確保組織的所有成員都可以運行相同版本的命令。 這適用于構建和啟動命令。`nest new` 和 `nest generate` 命令不屬于 `build/execute` 管道的一部分，因此它們在不同的上下文中操作，并且不附帶內置 `package.json` 腳本。 對于大多數開發人員/團隊，建議使用包腳本來構建和執行他們的 `Nest` 項目。您可以通過這些腳本的選項(`—path`、`—webpack`、`—webpackPath`)或根據需要定制 `tsc` 或 `webpack` 編譯器選項文件(例如，`tsconfig.json` )來完全定制這些腳本的行為。您還可以自由地運行一個完全定制的構建過程來編譯 `TypeScript` (甚至可以直接使用 `ts-node` 執行 `TypeScript` )。 ### 向后兼容性 因為 `Nest` 應用程序是純 `TypeScript` 應用程序，所以以前版本的 `Nest` 構建/執行腳本將繼續運行。您不需要升級它們。您可以選擇在準備好時利用新的 `nest build` 和 `nest start` 命令，或者繼續運行以前的或定制的腳本。 ### 遷移 雖然不需要進行任何更改，但您可能希望使用新的 `CLI` 命令進行遷移，而不是使用諸如 `tsc-watch` 或 `ts-node` 之類的工具。在這種情況下，只需在全局和本地安裝最新版本的 `@nestjs/cli`: ```bash $ npm install -g @nestjs/cli $ cd /some/project/root/folder $ npm install -D @nestjs/cli ``` 然后，您可以用以下腳本替換 `package.json` 中定義的腳本： ```bash "build": "nest build", "start": "nest start", "start:dev": "nest start --watch", "start:debug": "nest start --debug --watch", ```