style: apply global formatting fixes (struct, spacing, zhlint)

This commit is contained in:
Baohua Yang
2026-02-21 11:08:52 -08:00
parent ad68b2d973
commit 79ac9c639a
159 changed files with 1708 additions and 882 deletions

View File

@@ -1,7 +1,11 @@
## 7.10 WORKDIR 指定工作目录
本节涵盖了相关内容与详细描述主要探讨以下几个方面
### 基本语法
如下代码块所示展示了相关示例
```docker
WORKDIR <工作目录路径>
```
@@ -12,6 +16,8 @@ WORKDIR <工作目录路径>
### 基本用法
如下代码块所示展示了相关示例
```docker
WORKDIR /app
@@ -24,8 +30,12 @@ COPY . . # 复制到 /app/
### 为什么需要 WORKDIR
本节涵盖了相关内容与详细描述主要探讨以下几个方面
#### 常见错误
如下代码块所示展示了相关示例
```docker
## ❌ 错误cd 在下一个 RUN 中无效
@@ -35,6 +45,8 @@ RUN echo "hello" > world.txt # 文件在根目录!
#### 原因分析
如下代码块所示展示了相关示例
```
RUN cd /app
@@ -46,10 +58,12 @@ RUN echo "hello" > world.txt
启动新容器(工作目录在 /)→ 创建 /world.txt
```
每个 RUN 都在新容器中执行**前一个 RUN 的内存状态包括工作目录不会保留**
每个 RUN 都在新容器中执行**前一个 RUN 的内存状态 (包括工作目录) 不会保留**
#### 正确做法
如下代码块所示展示了相关示例
```docker
## ✅ 正确:使用 WORKDIR
@@ -75,6 +89,8 @@ RUN pwd # 输出 /a/b/c
### 使用环境变量
如下代码块所示展示了相关示例
```docker
ENV APP_HOME=/app
WORKDIR $APP_HOME
@@ -86,6 +102,8 @@ RUN pwd # 输出 /app
### 多阶段构建中的 WORKDIR
如下代码块所示展示了相关示例
```docker
## 构建阶段
@@ -107,7 +125,11 @@ COPY --from=builder /build/dist .
### 最佳实践
#### 1. 尽早设置 WORKDIR
本节涵盖了相关内容与详细描述主要探讨以下几个方面
#### 1尽早设置 WORKDIR
如下代码块所示展示了相关示例
```docker
FROM node:20
@@ -119,7 +141,9 @@ COPY . .
CMD ["node", "server.js"]
```
#### 2. 使用绝对路径
#### 2使用绝对路径
如下代码块所示展示了相关示例
```docker
## ✅ 推荐:绝对路径,意图明确
@@ -131,7 +155,9 @@ WORKDIR /app
WORKDIR app
```
#### 3. 不要用 RUN cd
#### 3不要用 RUN cd
如下代码块所示展示了相关示例
```docker
## ❌ 避免
@@ -144,7 +170,9 @@ WORKDIR /app
RUN echo "hello" > world.txt
```
#### 4. 适时重置 WORKDIR
#### 4适时重置 WORKDIR
如下代码块所示展示了相关示例
```docker
WORKDIR /app