使用 Docker 容器化 TypeScript 应用：完整指南

为什么容器化 TypeScript 应用是现代开发者的必备技能

想象一下这种情况：你在自己的 MacBook 上编写了一个很棒的 TypeScript 应用，一切运行完美。当你将代码部署到 Ubuntu 服务器上时，却遇到了一大堆错误。熟悉吗？问题在于环境的差异：Node.js 版本、系统库、环境变量。Docker 一劳永逸地解决了这个痛点。TypeScript 应用的容器化允许你将代码及其所有依赖项打包到一个隔离的容器中，该容器在任何服务器、云端或同事的本地机器上都能以相同的方式运行。

在本文中，我们将探讨如何使用 Docker 正确地容器化 TypeScript 应用。你不仅会学到基本步骤，还会掌握高级技术：多阶段构建、镜像大小优化、依赖缓存以及环境变量的处理。我们开始吧！

什么是 Docker，为什么 TypeScript 开发者需要它

Docker 是一个用于在容器中创建、交付和运行应用的平台。容器是一个轻量级、自包含的环境，包含了运行你的 TypeScript 应用所需的一切：代码、运行时（Node.js）、系统工具、库和配置。

对于 TypeScript 项目来说，优势显而易见：

\n
• 环境可重现性 — 再也不会有“在我这能运行”和“在生产环境崩溃”的情况。
\n
• 隔离性 — 每个应用都在自己的容器中运行，不会干扰其他服务。
\n
• 可扩展性 — 通过 Docker Compose 或 Kubernetes 轻松启动 10 个 TypeScript 服务器实例。
\n
• 部署简单 — 一个镜像可以在任何平台上运行：AWS、Google Cloud、DigitalOcean 或本地环境。
\n

前置要求

在开始之前，请确保你已经安装了以下内容：

\n
• Docker — 从官方网站下载（支持 Windows、macOS、Linux）。
\n
• Node.js 版本 18 或更高（用于编译 TypeScript）。
\n
• TypeScript — 在项目中全局或本地安装。
\n

作为示例，我们将使用一个简单的基于 TypeScript 的 Express 应用。但这种方法具有通用性：你可以容器化任何 TypeScript 项目——从 Telegram 机器人到 NestJS 服务器。

项目结构

首先，我们创建一个最小的 TypeScript 应用结构：

my-typescript-app/\n├── src/\n│   └── index.ts\n├── package.json\n├── tsconfig.json\n└── Dockerfile

src/index.ts 文件将包含一个简单的 HTTP 服务器：

import express from 'express';\nconst app = express();\nconst PORT = process.env.PORT || 3000;\n\napp.get('/', (req, res) => {\n  res.send('Hello from TypeScript + Docker!');\n});\n\napp.listen(PORT, () => {\n  console.log(`Server is running on port ${PORT}`);\n});

包含基本配置的 tsconfig.json 文件：

{\n  "compilerOptions": {\n    "target": "ES2020",\n    "module": "commonjs",\n    "outDir": "./dist",\n    "rootDir": "./src",\n    "strict": true,\n    "esModuleInterop": true\n  }\n}

为 TypeScript 应用编写第一个 Dockerfile

最简单的方法是进行单阶段构建。但我们会直接采用正确的方式，创建一个多阶段构建。这可以将最终镜像的大小缩小数倍。

# Stage 1: Build\nFROM node:18-alpine AS builder\nWORKDIR /app\nCOPY package*.json ./\nRUN npm install\nCOPY . .\nRUN npm run build\n\n# Stage 2: Production\nFROM node:18-alpine\nWORKDIR /app\nCOPY --from=builder /app/dist ./dist\nCOPY --from=builder /app/package*.json ./\nRUN npm install --production\nEXPOSE 3000\nCMD ["node", "dist/index.js"]

我们来分解每个阶段：

\n
• bu