作為初級(jí)開(kāi)發(fā)人員，建立 Node.js 後端最具挑戰(zhàn)性的方面之一不是編寫(xiě)程式碼本身 - 而是以可擴(kuò)展的方式組織程式碼。今天，我們將探索一個(gè)可用於生產(chǎn)的 Node.js 專案結(jié)構(gòu)，您可以將其用作應(yīng)用程式的範(fàn)本。
非結(jié)構(gòu)化程式碼的問(wèn)題
在我們深入研究之前，想像嘗試在圖書(shū)館中找到一本特定的書(shū)，那裡的書(shū)是隨機(jī)放置在書(shū)架上的。令人沮喪，對(duì)吧？這同樣適用於程式碼。如果沒(méi)有適當(dāng)?shù)慕Y(jié)構(gòu)，您的 Node.js 應(yīng)用程式很快就會(huì)變成義大利麵條式程式碼的迷宮，難以維護(hù)和擴(kuò)展。
更好的方法：現(xiàn)代 Node.js 專案結(jié)構(gòu)
讓我們分解許多成功公司使用的專業(yè)級(jí) Node.js 專案結(jié)構(gòu)：
？後端/
├─？ src/
│ └── ? @types # TypeScript 類型定義
│ └──？ config # 設(shè)定檔
│ └── ?控制器 # 請(qǐng)求處理程序
│ └── ?實(shí)體 # 資料庫(kù)模型/實(shí)體
│ └── ? helper # 輔助/實(shí)用函數(shù)
│ └── ? middlewares # Express 中間件
│ └── ? paths # API 路由定義
│ └── ? services # 業(yè)務(wù)邏輯
│ └── ? types # 附加型別定義
│ └── ? utils # 實(shí)用函數(shù)
└──？ app.ts # 應(yīng)用程式入口點(diǎn)
└──？ .eslintrc.js # ESLint 設(shè)定
└──？ .prettierrc # 更漂亮的配置
└──？ Dockerfile # Docker 配置
└──？ package.json # 專案依賴
└──？ tsconfig.json # TypeScript 配置
└──？ .dockerignore # Docker 忽略規(guī)則
└──？ .env # 環(huán)境變數(shù)
└──？ docker-compose.yml # Docker Compose 配置
了解每個(gè)組件
1. @型別與型別目錄
`// @types/express/index.d.ts
declare namespace Express {
export interface Request {
user?: {
id: string;
role: string;
};
}
}`
這些資料夾包含 TypeScript 類型定義。 @types 資料夾通常包含外部模組的聲明，而 types 保存特定於應(yīng)用程式的類型。
2。配置目錄
// config/database.ts
export const dbConfig = {
host: process.env.DB_HOST,
port: process.env.DB_PORT,
username: process.env.DB_USER,
// … other configuration
};
目錄包含所有設(shè)定文件，可以輕鬆管理不同的環(huán)境（開(kāi)發(fā)、登臺(tái)、生產(chǎn)）。
3?？刂破?/strong>
// controllers/userController.ts
export class UserController {
async getUser(req: Request, res: Response) {
try {
const user = await userService.findById(req.params.id);
res.json(user);
} catch (error) {
res.status(500).json({ error: error.message });
}
}
}
控制器處理 HTTP 請(qǐng)求和回應(yīng)，充當(dāng)路由和服務(wù)之間的橋樑。
4。實(shí)體
typescript// entity/User.ts
@Entity()
export class User {
@PrimaryGeneratedColumn()
id: number;
@Column()
username: string;
@Column()
email: string;
}
實(shí)體目錄包含您的資料庫(kù)模型，通常使用 TypeORM 或 Sequelize 等 ORM。
5。服務(wù)
services/userService.ts
export class UserService {
async createUser(userData: CreateUserDto) {
const user = new User();
Object.assign(user, userData);
return await this.userRepository.save(user);
}
}
服務(wù)包含您的業(yè)務(wù)邏輯，使其與控制器分開(kāi)。
6。中介軟體
`// @types/express/index.d.ts
declare namespace Express {
export interface Request {
user?: {
id: string;
role: string;
};
}
}`
中間件處理橫切問(wèn)題，例如驗(yàn)證、日誌記錄和錯(cuò)誤處理。
最佳實(shí)務(wù)與技巧
1。單一職責(zé)： 每個(gè)目錄都應(yīng)該有明確的、單一的目的。不要將業(yè)務(wù)邏輯與路由定義混合在一起。
2。依賴注入：使用依賴注入讓你的程式碼更容易測(cè)試和維護(hù)。
// config/database.ts
export const dbConfig = {
host: process.env.DB_HOST,
port: process.env.DB_PORT,
username: process.env.DB_USER,
// … other configuration
};
3。環(huán)境配置：使用.env檔案作為環(huán)境特定的變量，並且永遠(yuǎn)不要將它們提交到版本控制。
4。 Docker 整合： Dockerfile 和 docker-compose.yml 的存在表明容器化支持，使跨環(huán)境的部署保持一致。
要避免的常見(jiàn)陷阱
循環(huán)依賴：小心不要在模組之間創(chuàng)建循環(huán)依賴。
海量文件：如果文件變得太大，則可能是做得太多了。將其分成更小、更集中的模組。
不一致的錯(cuò)誤處理：在您的應(yīng)用程式中建立一致的錯(cuò)誤處理策略。
結(jié)論
結(jié)構(gòu)良好的 Node.js 應(yīng)用程式對(duì)於長(zhǎng)期可維護(hù)性和可擴(kuò)展性至關(guān)重要。此結(jié)構(gòu)提供了堅(jiān)實(shí)的基礎(chǔ)，您可以隨著應(yīng)用程式的成長(zhǎng)而建立該基礎(chǔ)。請(qǐng)記住，我們的目標(biāo)不僅僅是讓它發(fā)揮作用，而是讓它可維護(hù)、可擴(kuò)展並且使用起來(lái)愉快。
下次啟動(dòng)新的 Node.js 專案時(shí)，請(qǐng)考慮使用此結(jié)構(gòu)作為範(fàn)本。它將節(jié)省您無(wú)數(shù)的重構(gòu)時(shí)間，並使您的程式碼庫(kù)從第一天起就更加專業(yè)。
專業(yè)提示：使用此結(jié)構(gòu)建立範(fàn)本儲(chǔ)存庫(kù)，以便您可以快速啟動(dòng)具有相同組織的新專案。
以上是Node.js 後端建立可擴(kuò)展的應(yīng)用程式：專案結(jié)構(gòu)實(shí)用指南的詳細(xì)內(nèi)容。更多資訊請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！
熱AI工具
Undress AI Tool
免費(fèi)脫衣圖片
Undresser.AI Undress
人工智慧驅(qū)動(dòng)的應(yīng)用程序，用於創(chuàng)建逼真的裸體照片
AI Clothes Remover
用於從照片中去除衣服的線上人工智慧工具。
Clothoff.io
AI脫衣器
Video Face Swap
使用我們完全免費(fèi)的人工智慧換臉工具，輕鬆在任何影片中換臉！
熱門(mén)文章
熱工具
記事本++7.3.1
好用且免費(fèi)的程式碼編輯器
SublimeText3漢化版
中文版，非常好用
禪工作室 13.0.1
強(qiáng)大的PHP整合開(kāi)發(fā)環(huán)境
Dreamweaver CS6
視覺(jué)化網(wǎng)頁(yè)開(kāi)發(fā)工具
SublimeText3 Mac版
神級(jí)程式碼編輯軟體(SublimeText3)
熱門(mén)話題
如何在JS中與日期和時(shí)間合作？
Jul 01, 2025 am 01:27 AM
JavaScript中的日期和時(shí)間處理需注意以下幾點(diǎn)：1.創(chuàng)建Date對(duì)像有多種方式，推薦使用ISO格式字符串以保證兼容性；2.獲取和設(shè)置時(shí)間信息可用get和set方法，注意月份從0開(kāi)始；3.手動(dòng)格式化日期需拼接字符串，也可使用第三方庫(kù)；4.處理時(shí)區(qū)問(wèn)題建議使用支持時(shí)區(qū)的庫(kù)，如Luxon。掌握這些要點(diǎn)能有效避免常見(jiàn)錯(cuò)誤。
為什麼要將標(biāo)籤放在的底部？
Jul 02, 2025 am 01:22 AM
PlacingtagsatthebottomofablogpostorwebpageservespracticalpurposesforSEO,userexperience,anddesign.1.IthelpswithSEObyallowingsearchenginestoaccesskeyword-relevanttagswithoutclutteringthemaincontent.2.Itimprovesuserexperiencebykeepingthefocusonthearticl
什麼是在DOM中冒泡和捕獲的事件？
Jul 02, 2025 am 01:19 AM
事件捕獲和冒泡是DOM中事件傳播的兩個(gè)階段，捕獲是從頂層向下到目標(biāo)元素，冒泡是從目標(biāo)元素向上傳播到頂層。 1.事件捕獲通過(guò)addEventListener的useCapture參數(shù)設(shè)為true實(shí)現(xiàn)；2.事件冒泡是默認(rèn)行為，useCapture設(shè)為false或省略；3.可使用event.stopPropagation()阻止事件傳播；4.冒泡支持事件委託，提高動(dòng)態(tài)內(nèi)容處理效率；5.捕獲可用於提前攔截事件，如日誌記錄或錯(cuò)誤處理。了解這兩個(gè)階段有助於精確控制JavaScript響應(yīng)用戶操作的時(shí)機(jī)和方式。
如何減少JavaScript應(yīng)用程序的有效載荷大小？
Jun 26, 2025 am 12:54 AM
如果JavaScript應(yīng)用加載慢、性能差，問(wèn)題往往出在payload太大，解決方法包括：1.使用代碼拆分（CodeSplitting），通過(guò)React.lazy()或構(gòu)建工具將大bundle拆分為多個(gè)小文件，按需加載以減少首次下載量；2.移除未使用的代碼（TreeShaking），利用ES6模塊機(jī)制清除“死代碼”，確保引入的庫(kù)支持該特性；3.壓縮和合併資源文件，啟用Gzip/Brotli和Terser壓縮JS，合理合併文件並優(yōu)化靜態(tài)資源；4.替換重型依賴，選用輕量級(jí)庫(kù)如day.js、fetch
JavaScript模塊上的確定JS綜述：ES模塊與COMPORJS
Jul 02, 2025 am 01:28 AM
ES模塊和CommonJS的主要區(qū)別在於加載方式和使用場(chǎng)景。 1.CommonJS是同步加載，適用於Node.js服務(wù)器端環(huán)境；2.ES模塊是異步加載，適用於瀏覽器等網(wǎng)絡(luò)環(huán)境；3.語(yǔ)法上，ES模塊使用import/export，且必須位於頂層作用域，而CommonJS使用require/module.exports，可在運(yùn)行時(shí)動(dòng)態(tài)調(diào)用；4.CommonJS廣泛用於舊版Node.js及依賴它的庫(kù)如Express，ES模塊則適用於現(xiàn)代前端框架和Node.jsv14 ；5.雖然可混合使用，但容易引發(fā)問(wèn)題
如何在node.js中提出HTTP請(qǐng)求？
Jul 13, 2025 am 02:18 AM
在Node.js中發(fā)起HTTP請(qǐng)求有三種常用方式：使用內(nèi)置模塊、axios和node-fetch。 1.使用內(nèi)置的http/https模塊無(wú)需依賴，適合基礎(chǔ)場(chǎng)景，但需手動(dòng)處理數(shù)據(jù)拼接和錯(cuò)誤監(jiān)聽(tīng)，例如用https.get()獲取數(shù)據(jù)或通過(guò).write()發(fā)送POST請(qǐng)求；2.axios是基於Promise的第三方庫(kù)，語(yǔ)法簡(jiǎn)潔且功能強(qiáng)大，支持async/await、自動(dòng)JSON轉(zhuǎn)換、攔截器等，推薦用於簡(jiǎn)化異步請(qǐng)求操作；3.node-fetch提供類似瀏覽器fetch的風(fēng)格，基於Promise且語(yǔ)法簡(jiǎn)單
編寫(xiě)清潔和可維護(hù)的JavaScript代碼的最佳實(shí)踐是什麼？
Jun 23, 2025 am 12:35 AM
要寫(xiě)出乾淨(jìng)、可維護(hù)的JavaScript代碼，應(yīng)遵循以下四點(diǎn)：1.使用清晰一致的命名規(guī)範(fàn)，變量名用名詞如count，函數(shù)名用動(dòng)詞開(kāi)頭如fetchData()，類名用PascalCase如UserProfile；2.避免過(guò)長(zhǎng)函數(shù)和副作用，每個(gè)函數(shù)只做一件事，如將更新用戶信息拆分為formatUser、saveUser和renderUser；3.合理使用模塊化和組件化，如在React中將頁(yè)面拆分為UserProfile、UserStats等小組件；4.寫(xiě)註釋和文檔時(shí)點(diǎn)到為止，重點(diǎn)說(shuō)明關(guān)鍵邏輯、算法選
垃圾收集如何在JavaScript中起作用？
Jul 04, 2025 am 12:42 AM
JavaScript的垃圾回收機(jī)制通過(guò)標(biāo)記-清除算法自動(dòng)管理內(nèi)存，以減少內(nèi)存洩漏風(fēng)險(xiǎn)。引擎從根對(duì)像出發(fā)遍歷並標(biāo)記活躍對(duì)象，未被標(biāo)記的則被視為垃圾並被清除。例如，當(dāng)對(duì)像不再被引用（如將變量設(shè)為null），它將在下一輪迴收中被釋放。常見(jiàn)的內(nèi)存洩漏原因包括：①未清除的定時(shí)器或事件監(jiān)聽(tīng)器；②閉包中對(duì)外部變量的引用；③全局變量持續(xù)持有大量數(shù)據(jù)。 V8引擎通過(guò)分代回收、增量標(biāo)記、並行/並發(fā)回收等策略優(yōu)化回收效率，降低主線程阻塞時(shí)間。開(kāi)發(fā)時(shí)應(yīng)避免不必要的全局引用、及時(shí)解除對(duì)象關(guān)聯(lián)，以提升性能與穩(wěn)定性。
