Cheat Sheet on 纪伟的个人博客

VS Code 使用指南：高效编写与阅读 Markdown

Wed, 11 Mar 2026 10:00:00 +0800

写在前面

Markdown 的门槛很低，但“能写”和“能高效维护长文档”是两件事。当一篇文章包含几十个标题、大量代码块、图片和相对链接时，工具应该帮我们看清结构、快速跳转、即时预览并在提交前发现问题。

VS Code 对 Markdown 的内置支持已经覆盖编辑、大纲、跳转、预览、智能提示和链接校验等常见需求。本文先用好内置能力，再讨论扩展。

快捷键会受操作系统、键盘布局和用户自定义影响。如果本文键位与本机不同，在命令面板搜索命令名，或打开 Preferences: Open Keyboard Shortcuts 查看当前绑定。

一、把文章目录作为工作区打开

不要只打开一个孤立的 index.md，而是打开项目或文章目录：

1

code .

这样文件搜索、全文搜索、图片路径、Git 差异和工作区标题跳转才有完整上下文。

常用入口：

Ctrl+P：按文件名快速打开。
Ctrl+Shift+P：打开命令面板。
Ctrl+Shift+F：在工作区全文搜索。
Ctrl+Shift+E：切换到资源管理器。
Ctrl+Shift+G：查看 Git 更改。

本文快捷键以 Windows / Linux 为主；macOS 可在命令面板中搜索同名命令查看当前绑定。

二、预览 Markdown

Ctrl+Shift+V：在当前编辑器打开预览。
Ctrl+K V：在侧边打开预览。

侧边预览最适合写作：左边编辑源码，右边观察标题、列表、代码块和图片的实际结构。VS Code 会在源码与预览之间同步滚动。

预览不等于最终站点渲染。Hugo 主题、Shortcode、Goldmark 配置和自定义 CSS 可能导致差异，因此文章完成后仍要用 Hugo 预览。

三、用大纲审查文章结构

资源管理器底部的 Outline 会把 Markdown 标题显示为树。它不只用于跳转，还能发现结构问题：

## 后突然出现 ####，可能跳级。
同级标题粒度明显不一致。
某一节层级过深，可能需要拆分。

Ctrl+Shift+O 在当前文件的标题间跳转，Ctrl+T 可搜索工作区中的符号，也能找到 Markdown 标题。

长文章中还可使用折叠：点击行号右侧的折叠控件，或通过命令面板执行 Fold All、Unfold All。

四、多光标与批量编辑

Alt+单击：添加光标。
Ctrl+Alt+↑/↓：在上下行添加光标。
Ctrl+D：选中下一个匹配项。
Ctrl+Shift+L：选中所有匹配项。
Alt+↑/↓：上下移动当前行或选区。
Shift+Alt+↑/↓：向上或向下复制。

典型用法包括为多行同时加列表符号、批量更换标题前缀，以及把一组纯文本改成表格列。

五、Markdown 编辑的内置能力

在 Markdown 中按 Ctrl+Space 可触发建议，VS Code 内置了链接、图片和代码块等 Snippet。

输入链接时，VS Code 可以对工作区文件、标题锚点和路径提供补全。对于长期维护的文档库，这比手工输入路径更安全。

建议打开以下编辑器能力：

1
2
3
4
5
6
7
8


{
 "editor.wordWrap": "on",
 "editor.minimap.enabled": false,
 "editor.renderWhitespace": "boundary",
 "files.trimTrailingWhitespace": true,
 "markdown.validate.enabled": true,
 "markdown.updateLinksOnFileMove.enabled": "prompt"
}

markdown.updateLinksOnFileMove.enabled 能在 Markdown 文件或被链接资源移动时提示更新链接。提交前仍应检查 Git Diff，确认没有扩大替换范围。

内置校验只检查本地文件、图片和标题锚点，不会请求外部 HTTP(S) 地址。外链可用性仍需使用站点链接检查器或在审校时单独核实。

六、表格、代码块与图片

6.1 表格

表格应优先表达对照关系，不要用它承载长段落。原始 Markdown 不必强行手工对齐，但列数必须一致。

1
2
3
4
5


| Tool | Pipeline | Platform |
| --- | --- | --- |
| Batch | Text | Windows |
| PowerShell | Object | Cross-platform |
| Bash | Text | Unix-like |

6.2 代码块

围栏后注明语言，这会影响语法高亮：

1
2
3


```powershell
Get-ChildItem | Where-Object Length -GT 1MB
```

内层包含三个反引号时，外层示例可以使用四个反引号，避免提前闭合。

6.3 Hugo Leaf Bundle 图片

1
2
3


my-post/
├── index.md
└── pipeline.png

1

![命令处理流程](pipeline.png)

图片与 index.md 放在一起，文章目录移动时资源也会一起移动。不要用只在本机成立的绝对路径。

七、专注写作与阅读

Ctrl+K Z：进入 Zen Mode，隐藏大部分界面。
Esc Esc：退出 Zen Mode。
View: Toggle Centered Layout：将编辑区居中，减少超宽屏上的视线移动。
View: Toggle Word Wrap：在当前文件切换自动换行。

阅读长文时，可以将预览放在单独的编辑器组，锁定预览后再在左侧切换其他文件，避免预览页被活动文件跟随切换。

八、Snippet：固化文章骨架

通过 Preferences: Configure User Snippets 为 Markdown 创建 Snippet：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19


{
 "Hugo post skeleton": {
 "prefix": "hpost",
 "body": [
 "+++",
 "date = '${CURRENT_YEAR}-${CURRENT_MONTH}-${CURRENT_DATE}T10:00:00+08:00'",
 "draft = true",
 "title = '$1'",
 "categories = ['$2']",
 "tags = ['$3']",
 "+++",
 "",
 "## 写在前面",
 "",
 "$0"
 ],
 "description": "Create a Hugo post skeleton"
 }
}

Snippet 适合固定格式，不适合复制大段通用套话。文章结构应由主题决定，而不是被模板限制。

九、扩展的选择原则

先确认内置功能是否已经满足需求，再安装扩展。常见需求可以分为：

Markdown lint：检查标题、列表、空行和围栏等风格。
拼写检查：适合英文文档，但需为专业词汇维护字典。
粘贴图片：将剪贴板图片保存到指定目录并插入链接。
表格格式化：降低手工对齐成本。

安装前检查发布者、最近更新、权限和工作区信任模式下的行为。扩展会执行代码，不应把“装得多”当成功能完整的标志。

十、Hugo 文章的完整工作流

10.1 创建文章

1

hugo new posts/devtools/my-post/index.md

10.2 编写时

用 Outline 先建立标题骨架。
使用 Ctrl+K V 侧边预览。
图片放到 index.md 旁边，使用相对路径。
代码围栏注明语言。
使用工作区搜索核对内部链接和系列名。

10.3 本地预览

1

hugo server --buildDrafts --buildFuture

VS Code 的 Markdown 预览负责快速反馈，Hugo 预览负责最终语义。两者不应互相取代。

10.4 提交前

确认 front matter 和 draft 状态。
通过 Outline 检查标题层级。
确认图片都存在。
检查围栏是否成对。
在 Source Control 中逐块阅读差异。
发布文章时同步 posts-index.md。
执行生产等价 Hugo 构建。

十一、最值得记住的快捷键

目标	Windows / Linux
命令面板	`Ctrl+Shift+P`
快速打开文件	`Ctrl+P`
当前文件标题	`Ctrl+Shift+O`
工作区符号	`Ctrl+T`
Markdown 预览	`Ctrl+Shift+V`
侧边预览	`Ctrl+K V`
触发建议	`Ctrl+Space`
全文搜索	`Ctrl+Shift+F`
Zen Mode	`Ctrl+K Z`

真正提升 Markdown 体验的不是背下所有快捷键，而是形成稳定闭环：用大纲控制结构，用侧边预览检查表达，用工作区能力管理资源与链接，用 Git Diff 守住最后一关。

参考资料

命令行脚本实战（三）：Bash Shell 语法与 Linux 自动化

Mon, 09 Mar 2026 10:00:00 +0800

写在前面

Shell 不是某一种固定语法，而是命令解释器这一类程序的统称。sh 可以指历史上的 Bourne Shell、POSIX 定义的可移植语法，或系统上名为 sh 的兼容实现。Bash 是 GNU 项目的 Shell，在 Linux 服务器和 CI 脚本中非常常见。

本文明确使用 Bash；如果脚本必须由 /bin/sh 运行，就不应使用 Bash 数组、[[ ... ]] 等扩展。

系列导航：第一篇：Windows Batch · 第二篇：PowerShell

一、Shebang 与执行方式

1
2
3


#!/usr/bin/env bash

echo "Hello, Bash!"

1
2


chmod +x script.sh
./script.sh

./script.sh 按 Shebang 选择解释器，bash script.sh 则明确交给 Bash。source script.sh 在当前 Shell 中执行，可以改变当前会话的变量和工作目录，不能与启动子进程混为一谈。

二、变量、环境变量与参数

1
2
3
4
5


name="demo"
port=8080
readonly app_env="production"

export LOG_LEVEL="info"

赋值等号两边不能有空格。普通变量只存在于当前 Shell，export 后才会传给子进程。

1
2
3
4


echo "script: $0"
echo "first: ${1:-default}"
echo "count: $#"
printf 'arg: <%s>\n' "$@"

"$@" 会保留每个参数的边界，是转发参数的标准写法。不加引号的 $@ 会再经历分词和文件名展开。

三、引号与 Shell 展开

1
2
3
4
5


name="Bash"
echo '$name' # 原样字符
echo "Hello, $name" # 变量展开
echo "kernel: $(uname -s)" # 命令替换
echo "$((2 + 3))" # 算术展开

Bash 的展开包括大括号展开、波浪号展开、参数展开、命令替换、算术展开、单词分割和文件名展开等。这也是 Shell 很多陷阱的根源。

1
2
3


file="report final.md"
rm -- "$file" # 正确：一个参数
# rm $file # 错误：可能被拆成两个参数

一条实用规则是：变量展开默认加双引号，只在明确需要分词或 glob 时才取消。

四、参数展开

1
2
3
4
5
6
7


name="${1:-guest}" # 空或未定义时用默认值
: "${API_KEY:?API_KEY is required}"

path="/var/log/app.log"
echo "${path##*/}" # app.log
echo "${path%/*}" # /var/log
echo "${#path}" # 长度

${var:-default} 不会修改变量，${var:=default} 会赋值。${var:?message} 适合在脚本开始处校验必需配置。

五、条件与 case

1
2
3
4
5
6
7


if [[ -f "$file" ]]; then
 echo "regular file"
elif [[ -d "$file" ]]; then
 echo "directory"
else
 echo "missing"
fi

[[ ... ]] 是 Bash 条件语法，比传统 [ ... ] 更适合 Bash 脚本；需要 POSIX sh 兼容时使用 [ ... ]。

1
2
3
4
5


case "${1:-}" in
 start|restart) echo "starting" ;;
 stop) echo "stopping" ;;
 *) echo "usage: $0 {start|stop|restart}" >&2; exit 2 ;;
esac

六、循环、数组与读取文件

1
2
3
4
5
6
7
8


for file in ./*.md; do
 [[ -e "$file" ]] || continue
 printf '%s\n' "$file"
done

for ((i = 0; i < 5; i++)); do
 echo "$i"
done

1
2
3
4


services=(api worker scheduler)
for service in "${services[@]}"; do
 echo "$service"
done

逐行读取时避免 for line in $(cat file)：

1
2
3


while IFS= read -r line; do
 printf 'line: %s\n' "$line"
done < names.txt

IFS= 避免剪掉首尾空白，-r 避免把反斜杠解释为转义。

七、函数与返回状态

1
2
3
4
5
6
7
8


log() {
 printf '[%s] %s\n' "$(date '+%F %T')" "$*"
}

ensure_directory() {
 local dir=$1
 [[ -d "$dir" ]] || mkdir -p -- "$dir"
}

Shell 函数的 return 返回 0–255 状态码，不是任意数据。数据通常通过标准输出产生，调用者再用命令替换接收：

1
2
3
4
5


get_version() {
 printf '%s\n' '1.0.0'
}

version=$(get_version)

日志如果不属于函数的数据输出，应写入标准错误：printf 'message\n' >&2。

八、管道、重定向与状态码

1
2
3


command >stdout.log 2>stderr.log
command >all.log 2>&1
printf '%s\n' a b c | sort | uniq

Unix 命令的约定是 0 表示成功，非 0 表示失败。

1
2
3
4
5


if curl -fsS https://example.com/health; then
 echo "healthy"
else
 echo "unhealthy" >&2
fi

1
2


build && deploy
cleanup || echo "cleanup failed" >&2

九、`set -euo pipefail` 不是魔法

1

set -Eeuo pipefail

-u：读取未定义变量时报错。
-o pipefail：管道中任一命令失败时，管道可返回非零状态。
-e：在诸多非零状态场景下退出，但存在重要例外。
-E（errtrace）：让 ERR trap 由 Shell 函数、命令替换和子 Shell 环境继承。

set -e 在 if 条件、while 条件、&& / || 列表、被 ! 取反的命令等上下文中不按“遇到非零立即退出”的简化规则工作。因此关键命令仍应显式地放在 if 中或检查其状态。

十、完整实战：构建并打包 Hugo 站点

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30


#!/usr/bin/env bash
set -Eeuo pipefail

readonly script_dir="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
readonly output_dir="${script_dir}/public"

log() {
 printf '[%s] %s\n' "$(date '+%F %T')" "$*"
}

on_error() {
 local exit_code=$?
 local line_no=$1
 printf '[ERROR] line %s, exit code %s\n' "$line_no" "$exit_code" >&2
 exit "$exit_code"
}
trap 'on_error "$LINENO"' ERR

command -v hugo >/dev/null 2>&1 || {
 echo '[ERROR] hugo was not found in PATH' >&2
 exit 10
}

cd -- "$script_dir"
log 'Building site'
hugo --minify --buildFuture --cleanDestinationDir -d "$output_dir"

log 'Creating archive'
tar -C "$output_dir" -czf "${script_dir}/site.tar.gz" .
log 'Done'

${BASH_SOURCE[0]} 指向当前 Bash 源文件，比 $0 更适合函数和被 source 的场景。cd ... && pwd 将脚本目录规范化为绝对路径。

十一、常见陷阱

不加引号的变量可能触发分词和 glob。
不要用 for x in $(cat file) 逐行读取文件。
不要用 ls 的输出驱动文件处理，直接使用 glob 或 find 的结构化能力。
不要把 set -e 当成完整错误处理。
临时文件使用 mktemp，并通过 trap 清理。
对任意文件名处理时，优先使用 NUL 分隔，例如 find ... -print0。

十二、三种脚本怎么选

维度	Windows Batch	PowerShell	Bash
主要环境	Windows	Windows、Linux、macOS	Linux / Unix-like
管道数据	文本	.NET 对象	字节流 / 文本
优势	Windows 零依赖、兼容历史环境	结构化数据、系统管理、跨平台	Linux 工具链、CI/CD、远程运维
短板	语法易错、不擅长结构化数据	启动和语法相对更重	引号与展开规则复杂
典型场景	启动器、简单安装脚本	Windows 管理、API / JSON 自动化	服务器部署、命令编排

Batch 解决 Windows 零依赖启动，PowerShell 擅长对象和系统管理，Bash 则是 Linux 命令编排的粘合层。选择工具的关键不是“谁的语法更现代”，而是目标环境、数据形态和脚本复杂度。

系列回顾：第一篇：Windows Batch · 第二篇：PowerShell

参考资料

命令行脚本实战（二）：PowerShell 语法与对象管道

Sat, 07 Mar 2026 10:00:00 +0800

写在前面

PowerShell 的关键不是“另一种 Shell 语法”，而是对象管道。Bash 和 CMD 通常在命令间传递文本，PowerShell 则传递带类型、属性和方法的 .NET 对象。理解这一点，Where-Object、Select-Object 和 Get-Member 就不再是需要死记的命令。

本文以跨平台 PowerShell 7 为主。Windows 自带的 Windows PowerShell 5.1 与 PowerShell 7 可以并存，前者通常由 powershell.exe 启动，后者由 pwsh 启动。

系列导航：上一篇：Windows Batch · 下一篇：Bash Shell

一、Cmdlet 与发现式学习

Cmdlet 通常采用 Verb-Noun 命名：

1
2
3
4
5


Get-Process
Get-Service
Get-ChildItem
Set-Location
Remove-Item

不要先背整张命令表，而是学会发现：

1
2
3


Get-Command -Noun Service
Get-Help Get-ChildItem -Examples
Get-Process | Get-Member

Get-Command 找命令，Get-Help 看用法，Get-Member 看管道中对象的类型、属性和方法。

本文虽然以跨平台 PowerShell 7 为主，但 Cmdlet 的可用性仍取决于操作系统和已安装模块。例如 Get-Service 主要面向 Windows；跨平台脚本应在目标系统上用 Get-Command 检查依赖，不能只凭“PowerShell 7 可跨平台”推断所有命令都跨平台。

二、变量、集合与哈希表

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


$name = 'demo'
$count = 3
$enabled = $true
$nothing = $null

$numbers = 1, 2, 3
$config = @{
 Environment = 'production'
 Port = 8080
}

PowerShell 变量以 $ 开头，默认可动态变更类型，也可显式约束：

1
2
3


[int]$port = 8080
[datetime]$startedAt = Get-Date
[string[]]$names = 'api', 'worker'

自定义结构化数据可以用 [pscustomobject]：

1
2
3
4
5
6
7


$app = [pscustomobject]@{
 Name = 'orders-api'
 Port = 8080
 Healthy = $true
}

$app.Name

三、字符串与展开

1
2
3
4


$name = 'PowerShell'
'Hello, $name' # 不展开
"Hello, $name" # 展开
"2 + 3 = $(2 + 3)" # 子表达式

多行字符串使用 Here-string：

1
2
3
4
5
6


$json = @'
{
 "name": "demo",
 "enabled": true
}
'@

路径优先用 Join-Path，脚本目录使用 $PSScriptRoot：

1

$output = Join-Path $PSScriptRoot 'artifacts'

四、条件、循环与 switch

1
2
3
4
5
6
7


if ($port -ge 1 -and $port -le 65535) {
 'valid port'
} elseif ($port -eq 0) {
 'automatic port'
} else {
 throw "Invalid port: $port"
}

常见比较符有 -eq、-ne、-gt、-ge、-lt、-le、-like 和 -match。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


foreach ($file in Get-ChildItem -Filter *.md) {
 $file.FullName
}

1..5 | ForEach-Object { $_ * 2 }

switch -Regex ($status) {
 '^2\d\d$' { 'success'; break }
 '^4\d\d$' { 'client error'; break }
 default { 'other' }
}

foreach 是语言关键字，ForEach-Object 是管道命令，两者不是一回事。

五、对象管道

1
2
3
4


Get-Process |
 Where-Object CPU -GT 10 |
 Sort-Object CPU -Descending |
 Select-Object -First 5 Name, Id, CPU

Get-Process 输出的不是已排版的表格字符串，而是进程对象。后续命令直接读取 CPU、Name 等属性，无需切割文本列。

1
2
3
4


Get-ChildItem -File -Recurse |
 Where-Object Length -GT 10MB |
 Select-Object FullName, Length, LastWriteTime |
 Export-Csv large-files.csv -NoTypeInformation

Format-Table 和 Format-List 用于最终展示，通常应放在管道末端，不要在中途把格式化对象交给数据处理命令。

六、函数与参数

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15


function Get-LargeFile {
 [CmdletBinding()]
 param(
 [Parameter(Mandatory)]
 [string]$Path,

 [ValidateRange(1, 10240)]
 [int]$MinimumMB = 100
 )

 Get-ChildItem -LiteralPath $Path -File -Recurse |
 Where-Object Length -GE ($MinimumMB * 1MB)
}

Get-LargeFile -Path . -MinimumMB 20

可接收管道输入的高级函数可使用 begin、process、end 和 PowerShell 7.3 引入的 clean 块。大多数普通脚本先写清晰的 param() 就足够了。

七、文件、JSON 与 HTTP

1
2
3
4
5
6


$config = Get-Content -LiteralPath ./appsettings.json -Raw |
 ConvertFrom-Json

$config.Logging.LogLevel.Default = 'Warning'
$config | ConvertTo-Json -Depth 10 |
 Set-Content -LiteralPath ./appsettings.generated.json -Encoding utf8

1
2
3
4
5
6


$request = @{
 Uri = 'https://api.example.com/health'
 Method = 'Get'
}
$result = Invoke-RestMethod @request
$result.status

PowerShell 适合自动化的重要原因，就是 JSON、CSV、HTTP 和文件系统都能直接变成对象处理。PowerShell 不使用 Bash 的反斜杠续行；参数较多时，splatting 通常比行尾反引号更清晰。

八、错误处理与原生程序

1
2
3
4
5
6
7
8


try {
 Get-Content -LiteralPath ./missing.txt -ErrorAction Stop
} catch {
 Write-Error "Read failed: $($_.Exception.Message)"
 exit 1
} finally {
 'cleanup'
}

PowerShell 区分终止错误和非终止错误，需要 catch 的 Cmdlet 调用常配合 -ErrorAction Stop。

调用 git、dotnet 等原生程序后，检查 $LASTEXITCODE：

1
2
3
4


dotnet test
if ($LASTEXITCODE -ne 0) {
 throw "dotnet test failed: $LASTEXITCODE"
}

PowerShell 7 支持 && 和 || 管道链操作符：

1

dotnet test && dotnet publish -c Release

九、完整实战：生成文件清单

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25


[CmdletBinding()]
param(
 [string]$Path = $PSScriptRoot,
 [string]$Output = (Join-Path $PSScriptRoot 'files.json')
)

$ErrorActionPreference = 'Stop'

try {
 $root = (Resolve-Path -LiteralPath $Path).Path

 $items = Get-ChildItem -LiteralPath $root -File -Recurse |
 Select-Object @{Name='Path'; Expression={
 [IO.Path]::GetRelativePath($root, $_.FullName)
 }}, Length, LastWriteTimeUtc

 $items |
 ConvertTo-Json -Depth 3 |
 Set-Content -LiteralPath $Output -Encoding utf8

 Write-Host "Generated $Output ($($items.Count) files)"
} catch {
 Write-Error $_
 exit 1
}

这段脚本展示了 PowerShell 的典型优势：文件本来就是对象，投影后可以直接序列化成 JSON，不需要手工拼接文本。

十、快速选择

服务和进程：Get-Service、Get-Process
文件：Get-ChildItem、Copy-Item、Move-Item、Remove-Item
过滤：Where-Object
投影：Select-Object
排序与分组：Sort-Object、Group-Object
数据交换：ConvertFrom-Json、ConvertTo-Json、Import-Csv、Export-Csv
HTTP：Invoke-RestMethod、Invoke-WebRequest
自我发现：Get-Command、Get-Help、Get-Member

PowerShell 脚本的可维护性来自保留对象，而不是过早把一切变成文本。在管道中处理对象，在边界上输入或输出 JSON、CSV 和格式化文本，是最值得保留的设计原则。

系列导航：上一篇：Windows Batch · 下一篇：Bash Shell

参考资料

命令行脚本实战（一）：Windows Batch（BAT）语法与自动化

Thu, 05 Mar 2026 10:00:00 +0800

写在前面

Windows Batch 谈不上优雅，但它有一个很现实的优势：几乎每台 Windows 都能直接运行。启动程序、封装构建命令、复制文件、设置环境变量，一个 .bat 文件往往就够了。

本文不试图穷举 cmd.exe 的每个历史细节，而是建立一套能写出可维护 Batch 脚本的最小知识体系。

本系列共三篇：Windows Batch 负责 Windows 零依赖兼容，PowerShell 进入对象管道，Bash 面向 Linux 命令编排。

一、Batch、BAT 与 CMD

Batch 是由 Windows 命令解释器按顺序执行的批处理脚本。
.bat / .cmd 是常见脚本扩展名，现代 Windows 中大多数场景下行为相同。
cmd.exe 是解析和执行它们的程序。

一个最小脚本：

1
2
3


@echo off
echo Hello, Batch!
pause

@ 只隐藏当前命令，echo off 隐藏后续命令本身，但不会隐藏命令的输出。

二、参数、变量与引号

2.1 命令行参数

1
2
3
4


@echo off
echo script: %~f0
echo first: %~1
echo all: %*

%0 是脚本名，%1 到 %9 是位置参数，%* 是所有参数。%~1 会去掉外层引号，%~f0 会展开为脚本的绝对路径。

2.2 环境变量

1
2
3


set "APP_ENV=production"
set "OUTPUT_DIR=%~dp0artifacts"
echo %APP_ENV%

推荐使用 set "NAME=value"：引号不会进入变量值，又能避免行尾空格。%~dp0 表示脚本所在目录，适合构造与当前工作目录无关的路径。

路径可能含空格时，在使用处加引号：

1
2


if not exist "%OUTPUT_DIR%" mkdir "%OUTPUT_DIR%"
copy "%~1" "%OUTPUT_DIR%\"

三、条件判断

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


if "%~1"=="" (
 echo Usage: %~nx0 ^<file^>
 exit /b 2
)

if not exist "%~1" (
 echo File not found: %~1
 exit /b 3
)

if /i "%APP_ENV%"=="production" echo Production mode

数字比较使用 EQU、NEQ、LSS、LEQ、GTR 和 GEQ。参与比较的变量应先校验或给出默认值，否则变量为空或包含非数字内容时，展开后的 if 语句可能直接产生语法错误。

1
2


set /a COUNT=12
if %COUNT% GTR 10 echo Too many items

if errorlevel N 的含义是“退出码大于等于 N”，不是“等于 N”。现代脚本通常直接保存 %ERRORLEVEL%：

1
2
3


some-command
set "RC=%ERRORLEVEL%"
if not "%RC%"=="0" exit /b %RC%

四、循环与延迟展开

在交互式 CMD 中写 %F，在批处理文件中必须写 %%F：

1
2
3
4
5


for %%F in ("*.log") do echo %%~nxF

for /d %%D in ("*") do echo directory: %%~fD

for /l %%N in (1,1,5) do echo %%N

for /f 用于读文件或命令输出：

1

for /f "usebackq delims=" %%L in ("names.txt") do echo %%L

Batch 会在执行括号块前就展开 %VAR%。如果变量在块内变化，需要延迟展开：

1
2
3
4
5
6
7
8


@echo off
setlocal EnableDelayedExpansion
set /a COUNT=0

for %%F in ("*.log") do (
 set /a COUNT+=1
 echo !COUNT!: %%~nxF
)

!VAR! 是执行时展开。但文本本身包含 ! 时可能被误解析，处理任意用户文本时要特别小心。

五、管道、重定向与转义

1
2
3


tool.exe > output.log 2> error.log
tool.exe > all.log 2>&1
type app.log | findstr /i "error warning"

> 覆盖文件，>> 追加文件。
2> 重定向标准错误。
2>&1 让标准错误指向当前的标准输出。
^ 是 CMD 的常见转义符。

1
2


echo A ^& B
echo ^<value^>

六、子程序与作用域

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


@echo off
setlocal
call :EnsureDirectory "%~dp0artifacts"
if errorlevel 1 exit /b %ERRORLEVEL%
exit /b 0

:EnsureDirectory
if not exist "%~1" mkdir "%~1"
if errorlevel 1 exit /b 1
exit /b 0

call :Label 调用子程序，exit /b 返回调用者。setlocal 将环境变量变更限制在当前脚本，遇到 endlocal 或脚本结束时恢复。

七、完整实战：封装构建命令

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32


@echo off
setlocal EnableExtensions

set "ROOT=%~dp0"
set "PROJECT=%ROOT%src\Demo.csproj"
set "OUTPUT=%ROOT%artifacts"

where dotnet >nul 2>&1
if errorlevel 1 (
 echo [ERROR] dotnet was not found in PATH.
 exit /b 10
)

if not exist "%PROJECT%" (
 echo [ERROR] Project not found: %PROJECT%
 exit /b 11
)

if not exist "%OUTPUT%" mkdir "%OUTPUT%"
if errorlevel 1 exit /b 12

echo [INFO] Building %PROJECT%
dotnet publish "%PROJECT%" -c Release -o "%OUTPUT%"
set "RC=%ERRORLEVEL%"

if not "%RC%"=="0" (
 echo [ERROR] Build failed with exit code %RC%.
 exit /b %RC%
)

echo [INFO] Output: %OUTPUT%
exit /b 0

这个脚本有几个值得保留的习惯：路径基于 %~dp0，所有路径加引号，前置条件失败即返回，并把外部程序的退出码传递给调用者。

八、常见陷阱

不要写 set NAME = value，空格会成为变量名或值的一部分。
括号块内变化的变量需要延迟展开。
if errorlevel 1 是 >= 1，检查多个值时应从大到小。
不要假设工作目录就是脚本目录。
用 exit /b 退出脚本；慎用 exit，它可能关闭整个 CMD 会话。
Batch 对 JSON、复杂字符串和结构化数据很不友好，应及时转向 PowerShell 或其他语言。

九、什么时候使用 Batch

Batch 适合零依赖的 Windows 启动器、简单命令编排和兼容历史环境。如果脚本开始大量解析文本、访问 API、操作 JSON 或维护复杂错误分支，PowerShell 通常是 Windows 上更好的选择。

下一篇：PowerShell 语法与对象管道

参考资料

Kubectl 命令速查手册

Sun, 20 Oct 2024 10:00:00 +0800

写在前面

本文整理了日常使用 Kubernetes 最常用的 kubectl 命令，涵盖资源查看、部署管理、排错调试和集群运维。每个命令都力求实用，避免罗列用不到的冷门参数。

本文按 Kubernetes 1.36 官方文档复核。kubectl 通常只保证与 API Server 相差一个次版本时受支持，执行前应先查看客户端和服务端版本；示例中的 <...> 是必须替换的占位符，latest 镜像标签仅适合临时学习。

一、基础操作

1.1 集群信息

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17


# 查看集群信息
kubectl cluster-info

# 查看集群节点
kubectl get nodes

# 查看节点详细信息
kubectl describe node <node-name>

# 查看节点资源使用
kubectl top nodes

# 查看 kubeconfig 配置
kubectl config view

# 切换命名空间（需要 kubectx 或手动切换）
kubectl config set-context --current --namespace=<namespace>

1.2 命名空间

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16


# 查看所有命名空间
kubectl get namespaces
kubectl get ns

# 创建命名空间
kubectl create namespace dev

# 删除命名空间
kubectl delete namespace dev

# 在指定命名空间下操作（-n 或 --namespace）
kubectl get pods -n dev

# 查看所有命名空间的资源
kubectl get pods --all-namespaces
kubectl get pods -A

1.3 通用操作

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28


# 查看资源列表
kubectl get <resource> # 如 kubectl get pods
kubectl get <resource> -o wide # 显示更多信息
kubectl get <resource> -o yaml # 输出 YAML 格式
kubectl get <resource> -o json # 输出 JSON 格式
kubectl get <resource> -o name # 只显示资源名
kubectl get <resource> --show-labels # 显示标签
kubectl get <resource> --sort-by=.metadata.creationTimestamp # 按创建时间排序

# 查看资源详情
kubectl describe <resource> <name>

# 创建/更新资源
kubectl apply -f manifest.yaml # 推荐，幂等操作
kubectl apply -f ./manifests/ # 应用目录下所有文件
kubectl apply -f https://example.com/reviewed-manifest.yaml # 仅使用已审查并固定版本的可信清单

# 删除资源
kubectl delete -f manifest.yaml # 按文件删除
kubectl delete pod <pod-name> # 按名称删除
kubectl delete pod <pod-name> --grace-period=0 --force # 强制删除（卡住时用）

# 编辑资源
kubectl edit <resource> <name> # 打开编辑器修改

# 查看资源定义帮助
kubectl explain pod
kubectl explain pod.spec.containers

强制删除只会立即从 API 中移除对象，不保证节点上的旧进程已经停止；对有状态或单实例工作负载可能造成重复进程和数据损坏，必须先确认节点与存储状态。

二、Pod 管理

2.1 查看 Pod

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18


# 列出 Pod
kubectl get pods
kubectl get pods -o wide # 显示 IP 和所在节点
kubectl get pods -w # 持续监控变化（watch）
kubectl get pods --field-selector status.phase=Running # 按状态过滤

# 查看所有命名空间的 Pod
kubectl get pods -A

# 按标签筛选
kubectl get pods -l app=nginx
kubectl get pods -l 'app in (nginx, redis)'

# 查看 Pod 详情
kubectl describe pod <pod-name>

# 查看 Pod 的 YAML
kubectl get pod <pod-name> -o yaml

2.2 Pod 生命周期

1
2
3
4
5
6
7
8


Pod 状态：
Pending — 正在调度或拉取镜像
Running — 正在运行
Succeeded — 执行完成（Job/CronJob）
Failed — 执行失败
Unknown — 无法获取状态（通常是节点失联）
CrashLoopBackOff — 容器反复崩溃重启
ImagePullBackOff — 镜像拉取失败

2.3 快速创建 Pod

1
2
3
4
5
6


# 用命令行快速创建（临时测试用）
kubectl run nginx --image=nginx:latest
kubectl run busybox --image=busybox --rm -it -- /bin/sh # 运行后进入，退出自动删除

# 从 YAML 生成（不执行，输出到文件）
kubectl run nginx --image=nginx --dry-run=client -o yaml > pod.yaml

2.4 容器交互

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23


# 查看容器日志
kubectl logs <pod-name> # 查看当前日志
kubectl logs <pod-name> -f # 实时跟踪日志
kubectl logs <pod-name> -f --tail=100 # 最后100行，持续跟踪
kubectl logs <pod-name> -c <container-name> # 指定容器（多容器 Pod）
kubectl logs <pod-name> --previous # 查看上一次崩溃的日志（排错神器）
kubectl logs <pod-name> --since=1h # 最近1小时的日志
kubectl logs <pod-name> --since-time="2026-01-01T00:00:00Z"

# 进入容器
kubectl exec -it <pod-name> -- /bin/bash # 进入容器 shell
kubectl exec -it <pod-name> -- /bin/sh # 没有 bash 时用 sh
kubectl exec -it <pod-name> -c <container> -- sh # 指定容器

# 在容器中执行命令（不进入）
kubectl exec <pod-name> -- cat /etc/config/app.conf
kubectl exec <pod-name> -- env # 查看环境变量
kubectl exec <pod-name> -- df -h # 查看磁盘

# 文件拷贝
kubectl cp <pod-name>:/tmp/file.txt ./file.txt # 从容器拷贝到本地
kubectl cp ./file.txt <pod-name>:/tmp/file.txt # 从本地拷贝到容器
kubectl cp ./file.txt <pod-name>:/tmp/ -c <container> # 指定容器

kubectl cp 依赖容器镜像中存在 tar；精简镜像没有该命令时会失败。

2.5 端口转发

1
2
3
4
5


# 本地端口转发到 Pod（调试用）
kubectl port-forward <pod-name> 8080:80 # 本地8080 → Pod的80
kubectl port-forward <pod-name> 8080:80 3306:3306 # 同时转发多个端口
kubectl port-forward svc/<service-name> 8080:80 # 转发到 Service
kubectl port-forward deploy/<deploy-name> 8080:80 # 转发到 Deployment

三、工作负载管理

3.1 Deployment

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35


# 查看 Deployment
kubectl get deployments
kubectl get deploy

# 创建 Deployment
kubectl create deployment nginx --image=nginx:latest --replicas=3
kubectl create deployment nginx --image=nginx --replicas=3 --dry-run=client -o yaml > deploy.yaml

# 扩缩容
kubectl scale deployment nginx --replicas=5

# 更新镜像（触发滚动更新）
kubectl set image deployment/nginx nginx=nginx:1.25
kubectl edit deployment nginx # 直接编辑

# 查看滚动更新状态
kubectl rollout status deployment/nginx

# 查看更新历史
kubectl rollout history deployment/nginx

# 回滚到上一版本
kubectl rollout undo deployment/nginx

# 回滚到指定版本
kubectl rollout undo deployment/nginx --to-revision=2

# 暂停/恢复滚动更新（用于多次修改一次性生效）
kubectl rollout pause deployment/nginx
kubectl set image deployment/nginx nginx=nginx:1.25
kubectl set resources deployment/nginx -c nginx --limits=memory=512Mi
kubectl rollout resume deployment/nginx

# 查看 ReplicaSet（每个版本对应一个 RS）
kubectl get replicaset

3.2 StatefulSet

1
2
3
4
5
6
7
8
9


# 查看 StatefulSet
kubectl get statefulsets
kubectl get sts

# 扩缩容
kubectl scale statefulset mysql --replicas=3

# 查看详情
kubectl describe statefulset mysql

3.3 DaemonSet

1
2
3
4
5
6


# 查看 DaemonSet
kubectl get daemonsets
kubectl get ds

# 查看每个节点上的 Pod
kubectl get pods -o wide | grep <daemonset-name>

3.4 Job 和 CronJob

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 查看 Job
kubectl get jobs

# 查看 CronJob
kubectl get cronjobs

# 手动触发 CronJob
kubectl create job --from=cronjob/<cronjob-name> <job-name>

# 删除 Job
kubectl delete job <job-name>

四、服务与网络

4.1 Service

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20


# 查看 Service
kubectl get services
kubectl get svc

# 查看 Service 详情
kubectl describe svc <service-name>

# 查看 EndpointSlice 后端（Endpoints API 自 Kubernetes 1.33 起已弃用）
kubectl get endpointslice -l kubernetes.io/service-name=<service-name>

# 暴露 Deployment 为 Service
kubectl expose deployment nginx --port=80 --target-port=80 --type=ClusterIP
kubectl expose deployment nginx --port=80 --target-port=80 --type=NodePort
kubectl expose deployment nginx --port=80 --target-port=80 --type=LoadBalancer

# 常用 Service 类型：
# ClusterIP — 集群内部访问（默认）
# NodePort — 通过节点端口外部访问（30000-32767）
# LoadBalancer — 云厂商提供的负载均衡器
# ExternalName — 映射到外部 DNS 名

4.2 Ingress

1
2
3
4
5
6


# 查看 Ingress
kubectl get ingress
kubectl get ing

# 查看 Ingress 详情
kubectl describe ingress <ingress-name>

4.3 网络诊断

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


# 临时启动一个网络调试 Pod
kubectl run debug --image=busybox --rm -it --restart=Never -- sh

# 在调试 Pod 中测试 DNS
nslookup <service-name>
nslookup <service-name>.<namespace>.svc.cluster.local

# 测试 Service 连通性
wget -qO- http://<service-name>:<port>
curl http://<service-name>:<port>

# 查看集群 DNS 配置
kubectl get configmap coredns -n kube-system

五、配置与存储

5.1 ConfigMap

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


# 从字面量创建
kubectl create configmap app-config --from-literal=DB_HOST=mysql --from-literal=DB_PORT=3306

# 从文件创建
kubectl create configmap app-config --from-file=config.properties

# 从目录创建（目录下每个文件变成一个 key）
kubectl create configmap app-config --from-file=./config/

# 查看 ConfigMap
kubectl get configmaps
kubectl get cm
kubectl describe configmap app-config

5.2 Secret

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


# 创建 Secret
kubectl create secret generic db-secret --from-literal=username=admin --from-literal=password='P@ssw0rd'

# 创建 kubernetes.io/tls 类型的 Secret
kubectl create secret tls tls-secret --cert=./cert.pem --key=./key.pem

# 查看 Secret（内容是 base64 编码的）
kubectl get secrets
kubectl describe secret <secret-name>

# 解码查看 Secret 内容
kubectl get secret <secret-name> -o jsonpath='{.data.password}' | base64 --decode

5.3 PV 和 PVC

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


# 查看持久卷
kubectl get persistentvolumes
kubectl get pv

# 查看持久卷声明
kubectl get persistentvolumeclaims
kubectl get pvc

# 查看 PVC 绑定状态
kubectl get pvc -o wide

# 查看 PV 详情
kubectl describe pv <pv-name>
kubectl describe pvc <pvc-name>

六、排错调试

6.1 排查流程

1
2
3
4
5


Pod 一直 Pending → kubectl describe pod 查看 Events，可能是资源、调度约束或 PVC 等问题
Pod 一直 CrashLoopBackOff → kubectl logs --previous 查看上次崩溃日志
Pod ImagePullBackOff → 检查镜像名和镜像仓库权限
Service 无法访问 → 检查 EndpointSlice 是否有就绪后端，标签和端口是否匹配
Pod 间无法通信 → 检查 NetworkPolicy，检查 DNS 解析

6.2 常用排错命令

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22


# 查看 Pod 事件（排错第一步）
kubectl describe pod <pod-name> | grep -A 20 Events

# 查看 Pod 状态和重启次数
kubectl get pods -o wide

# 查看容器日志
kubectl logs <pod-name> --previous # 上次崩溃的日志
kubectl logs <pod-name> -c <container> -f # 指定容器，实时跟踪

# 进入容器排查
kubectl exec -it <pod-name> -- sh

# 查看 Pod 失败原因
kubectl get pod <pod-name> -o jsonpath='{.status.conditions[?(@.type=="Ready")].message}'

# 查看近期事件；kubectl events 在较新的 kubectl 中更适合按资源过滤
kubectl events --for pod/<pod-name>
kubectl get events --sort-by='.metadata.creationTimestamp'

# 查看 API Server 暴露的 Prometheus 指标（需要相应 RBAC 权限）
kubectl get --raw /metrics

6.3 资源使用

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 查看节点资源使用（需要 metrics-server）
kubectl top nodes

# 查看 Pod 资源使用
kubectl top pods
kubectl top pods -n <namespace>
kubectl top pods --sort-by=memory # 按内存排序
kubectl top pods --sort-by=cpu # 按 CPU 排序

# 安装 metrics-server（如果 top 命令报错）
kubectl apply -f https://github.com/kubernetes-sigs/metrics-server/releases/latest/download/components.yaml

七、标签与选择器

7.1 标签操作

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17


# 查看标签
kubectl get pods --show-labels

# 添加标签
kubectl label pod <pod-name> env=prod

# 修改标签（覆盖已有值）
kubectl label pod <pod-name> env=staging --overwrite

# 删除标签
kubectl label pod <pod-name> env-

# 按标签筛选
kubectl get pods -l app=nginx
kubectl get pods -l 'tier in (frontend,backend)'
kubectl get pods -l 'env!=debug'
kubectl get pods -l 'version in (v1, v2),app=nginx'

7.2 注解

1
2
3
4
5
6
7
8


# 添加注解
kubectl annotate pod <pod-name> description="测试 Pod"

# 查看注解
kubectl describe pod <pod-name> | grep -A 5 Annotations

# 删除注解
kubectl annotate pod <pod-name> description-

八、集群运维

8.1 节点管理

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20


# 查看节点详情
kubectl describe node <node-name>

# 节点资源使用
kubectl top nodes

# 标记节点为不可调度（维护前操作）
kubectl cordon <node-name>

# 恢复节点调度
kubectl uncordon <node-name>

# 驱逐节点上的 Pod（维护用）
kubectl drain <node-name> --ignore-daemonsets --delete-emptydir-data

# 查看节点标签
kubectl get nodes --show-labels

# 给节点打标签（用于调度）
kubectl label node <node-name> disktype=ssd

8.2 集群资源

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 查看 API 资源类型
kubectl api-resources

# 查看 API 版本
kubectl api-versions

# 查看 kubectl get all 所覆盖的一组常用内置资源；它不代表全部资源，也不包含任意 CRD
kubectl get all -A

# 检查当前 API Server 的就绪探针（ComponentStatus API 已弃用）
kubectl get --raw='/readyz?verbose'

8.3 RBAC

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 查看角色
kubectl get roles
kubectl get clusterroles

# 查看角色绑定
kubectl get rolebindings
kubectl get clusterrolebindings

# 查看角色详情
kubectl describe role <role-name>
kubectl describe clusterrole <clusterrole-name>

九、常用组合命令

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27


# 快速查看所有命名空间的 Pod 状态（排除 Running 的）
kubectl get pods -A --field-selector=status.phase!=Running

# 查看 CrashLoopBackOff 的 Pod
kubectl get pods -A | grep -E "CrashLoop|Error|Pending"

# 批量删除 Completed 状态的 Pod
kubectl get pods -A --field-selector=status.phase=Succeeded -o json | \
 kubectl delete -f -

# 批量删除 Evicted 状态的 Pod
kubectl get pods -A | grep Evicted | awk '{print $2 " --namespace=" $1}' | xargs -n 2 kubectl delete pod

# 查看 Deployment 的 Pod 模板镜像版本
kubectl get deployment <name> -o jsonpath='{.spec.template.spec.containers[*].image}'

# 查看所有 Deployment 的镜像版本
kubectl get deployments -A -o custom-columns='NAMESPACE:.metadata.namespace,NAME:.metadata.name,IMAGES:.spec.template.spec.containers[*].image'

# 快速导出资源定义（kubectl neat 是需另行安装的第三方插件）
kubectl get <resource> <name> -o yaml | kubectl neat

# 查看资源配额
kubectl describe resourcequota -n <namespace>

# 查看限制范围
kubectl describe limitrange -n <namespace>

十、kubectl 命令速查

按场景选命令

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


查状态 → kubectl get pods,svc,deploy -A
查日志 → kubectl logs <pod> -f --tail=100
查原因 → kubectl describe pod <pod>
进容器 → kubectl exec -it <pod> -- sh
调端口 → kubectl port-forward <pod> 8080:80
更新镜像 → kubectl set image deploy/<name> <container>=<image>
扩缩容 → kubectl scale deploy <name> --replicas=5
回滚 → kubectl rollout undo deploy/<name>
看资源 → kubectl top pods/nodes
节点维护 → kubectl drain <node> --ignore-daemonsets

输出格式

1
2
3
4
5


-o wide # 更多列（IP、节点等）
-o yaml # YAML 格式
-o json # JSON 格式
-o name # 只显示资源名
-o custom-columns # 自定义列

常用简写

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


po/pods → pod
svc/services → service
deploy/deployments → deployment
sts/statefulsets → statefulset
ds/daemonsets → daemonset
cm/configmaps → configmap
ns/namespaces → namespace
pv/persistentvolumes → persistentvolume
pvc/persistentvolumeclaims → persistentvolumeclaim
ing/ingress → ingress
no/nodes → node

上述 grep、awk、xargs、base64 --decode 和管道示例面向 Bash/POSIX 环境；PowerShell 的筛选、解码和引号规则不同，不应原样复制。

参考资料

Linux 性能诊断速查手册

Wed, 18 Sep 2024 10:00:00 +0800

写在前面

本文整理了 Linux 系统性能排查的常用命令和思路，涵盖 CPU、内存、磁盘、网络四大方向。按照"先定位问题方向，再深入排查"的逻辑组织，方便遇到性能问题时快速入手。

一、排查思路总览

遇到性能问题时，建议按以下顺序定位：

1
2
3
4
5
6
7


1. top / htop — 快速看全局，确认是 CPU、内存、还是 I/O 问题
2. 针对性深入排查：
 - CPU 高 → 进程级别分析（第三章）
 - 内存高 → 内存分配分析（第四章）
 - 磁盘慢 → I/O 分析（第五章）
 - 网络慢 → 网络分析（第六章）
3. 结合日志和监控确认根因

二、全局概览

2.1 top — 系统资源总览

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


# 实时查看系统资源使用情况
top

# 常用交互操作：
# P — 按 CPU 排序
# M — 按内存排序
# 1 — 展开显示每个 CPU 核心
# c — 显示完整命令行
# k — 终止指定进程（输入 PID）
# q — 退出

关键字段解读：

1
2
3
4
5
6
7
8


top - 14:30:01 up 30 days, 3:20, 2 users, load average: 2.5, 1.8, 1.2
# 当前时间 运行时间 用户数 负载均值（1分钟/5分钟/15分钟）

%Cpu(s): 25.0 us, 3.0 sy, 0.0 ni, 70.0 id, 1.5 wa, 0.5 si
# 用户态 内核态 空闲 I/O等待 软中断

MiB Mem : 7823.0 total, 256.0 free, 4096.0 used, 3471.0 buff/cache
# 总内存 空闲 已使用 缓冲/缓存

load average：三个数字分别表示过去 1、5、15 分钟的平均负载，包含可运行任务以及不可中断睡眠中的任务，并不等于 CPU 使用率。与逻辑 CPU 数比较只能作为线索；还要结合 vmstat 的 r/b、CPU 利用率和 I/O 指标判断。

wa（iowait）：表示 CPU 空闲期间存在未完成块 I/O 的时间比例。高值值得继续调查，但低值不能排除 I/O 瓶颈，高值也不能单独证明某块磁盘是根因。

2.2 htop — 增强版 top

1
2
3
4


# 更直观的资源监控（需安装）
htop

# 优势：支持鼠标、颜色区分、快捷键更友好、可直接看到每个核心使用率

2.3 uptime — 快速看负载

1
2
3


# 一行输出系统运行时间和负载
uptime
# 14:30:01 up 30 days, 3:20, 2 users, load average: 2.5, 1.8, 1.2

2.4 vmstat — 系统活动统计

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15


# 每隔2秒采样一次，共采5次
vmstat 2 5

# 关键列：
# r — 可运行任务数；持续高于逻辑 CPU 数提示 CPU 排队，需要结合利用率确认
# b — 不可中断睡眠中的任务数；持续非零提示有阻塞，应继续定位等待源
# swpd — 已使用的 swap 大小（持续增长说明内存不够）
# si — 每秒从 swap 读入内存（swap in）
# so — 每秒从内存写入 swap（swap out）
# bi — 每秒从磁盘读入的块数
# bo — 每秒写入磁盘的块数
# us — 用户态 CPU 时间百分比
# sy — 内核态 CPU 时间百分比
# id — 空闲 CPU 时间百分比
# wa — I/O 等待时间百分比

三、CPU 排查

3.1 定位高 CPU 进程

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 按CPU使用率排序，显示前10个进程
ps aux --sort=-%cpu | head -10

# 或者用 top 的批处理模式（适合脚本采集）
top -b -n 1 | head -20

# 查看指定进程的线程CPU占用
top -H -p <PID>

# 查看进程的所有线程
ps -T -p <PID>

3.2 分析进程在做什么

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


# 查看进程的系统调用（跟踪进程在干什么）
strace -p <PID> -c
# -c 会统计每种系统调用的次数和耗时，Ctrl+C 后输出汇总

# 实时跟踪进程的系统调用
strace -p <PID>

# 跟踪进程并统计耗时排序
strace -p <PID> -c -S time

# 只跟踪网络相关的系统调用
strace -p <PID> -e trace=network

3.3 perf — 性能分析

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 对指定进程做 CPU profiling（采样10秒）
sudo perf top -p <PID>

# 记录性能数据
sudo perf record -p <PID> -g -- sleep 10

# 查看记录的性能报告
sudo perf report

# 查看系统全局的热点函数
sudo perf top

3.4 常见 CPU 高的原因

1
2
3
4


计算密集型业务 → 正常，考虑优化算法或扩容
频繁 GC → java 应用的常见问题，查看 GC 日志
死循环 → 代码 bug，用 strace/perf 定位
上下文切换多 → 线程数过多，用 vmstat 看 cs 列

3.5 查看上下文切换

1
2
3
4
5
6
7
8


# 查看每秒上下文切换次数
vmstat 1 5
# 看 cs 列（context switch）

# 查看进程级别的自愿/非自愿上下文切换
pidstat -w 1 5
# cswch/s — 自愿上下文切换（主动让出 CPU）
# nvcswch/s — 非自愿上下文切换（被内核抢占，说明 CPU 竞争激烈）

四、内存排查

4.1 查看内存使用

1
2
3
4
5
6
7
8
9


# 查看内存总览
free -h
# total used free shared buff/cache available
# Mem: 7.6Gi 4.0Gi 256Mi 16Mi 3.4Gi 3.2Gi
# Swap: 2.0Gi 512Mi 1.5Gi

# 重要：看 available 而不是 free
# available = 系统实际可用内存（包含可回收的缓存）
# free 只是完全未使用的内存，通常很少

buff/cache 是内核用作缓冲的内存，应用需要时会自动释放，不算"被占用"。

4.2 进程内存排名

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


# 按内存使用率排序，显示前10
ps aux --sort=-%mem | head -10

# 查看指定进程的内存详情
cat /proc/<PID>/status | grep Vm
# VmRSS — 实际使用的物理内存（最常关注的）
# VmSize — 虚拟内存大小
# VmSwap — 使用的 swap 大小

# 查看进程内存映射
pmap -x <PID>

# 更直观的进程内存排序
smem -t -k -s rss # 需安装 smem

4.3 查看 swap 使用情况

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


# 查看哪些进程在使用 swap
for pid in $(ls /proc | grep -E '^[0-9]+$'); do
 swap=$(cat /proc/$pid/status 2>/dev/null | grep VmSwap | awk '{print $2}')
 if [ -n "$swap" ] && [ "$swap" -gt 0 ]; then
 name=$(cat /proc/$pid/cmdline 2>/dev/null | tr '\0' ' ')
 echo "PID: $pid Swap: ${swap}kB CMD: $name"
 fi
done | sort -k4 -rn | head -10

# 简化版：查看系统 swap 使用
swapon --show
cat /proc/swaps

4.4 slab 缓存分析

1
2
3
4
5
6
7
8


# 查看内核 slab 缓存占用
slabtop

# 查看内核内存使用概况
cat /proc/meminfo | grep -i slab
# Slab — slab 缓存总量
# SReclaimable — 可回收的 slab
# SUnreclaim — 不可回收的 slab（持续增长需关注）

4.5 常见内存问题的排查方向

1
2
3
4


available 持续下降 → 内存泄漏，用 pmap 或应用工具定位
Swap 使用量高 → 物理内存不够，考虑加内存或优化进程
进程 RSS 异常大 → 检查是否有内存泄漏，查看 heap dump
系统 OOM Kill → dmesg | grep -i oom 查看被杀的进程

4.6 OOM 日志查看

1
2
3
4
5
6
7


# 查看 OOM killer 记录
dmesg | grep -i "out of memory"
dmesg | grep -i "killed process"

# 从系统日志查看
grep -i "oom" /var/log/messages
journalctl -k | grep -i "oom"

五、磁盘 I/O 排查

5.1 iostat — 磁盘 I/O 统计

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 查看所有磁盘的 I/O 统计（每秒刷新）
iostat -x 1

# 关键指标：
# %util — 设备处理 I/O 的时间比例；对并行设备/虚拟设备不能直接当作饱和度
# await — I/O 从提交到完成的平均时间，需与设备类型和业务基线比较
# r/s — 每秒读次数
# w/s — 每秒写次数
# rkB/s — 每秒读速度（KB）
# wkB/s — 每秒写速度（KB）
# aqu-sz（旧版可能显示 avgqu-sz）— 平均队列长度，需结合并发能力和延迟判断

不存在跨 HDD、SSD、NVMe、RAID 和云盘都适用的固定阈值。用业务正常期基线对比 await、队列、吞吐、IOPS 与尾延迟，再关联到进程和具体请求。

5.2 iotop — 查看哪个进程在疯狂读写磁盘

1
2
3
4
5
6
7
8


# 实时查看各进程的磁盘 I/O（需 root）
sudo iotop

# 只看有 I/O 活动的进程
sudo iotop -o

# 批处理模式（适合脚本采集）
sudo iotop -b -o -n 3

5.3 pidstat — 按进程查看 I/O

1
2
3
4
5
6
7


# 查看各进程的磁盘读写（每秒刷新）
pidstat -d 1

# 输出说明：
# kB_rd/s — 每秒读 KB
# kB_wr/s — 每秒写 KB
# kB_ccwr/s — 每秒取消写入的 KB

5.4 查看磁盘使用空间

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 查看各磁盘使用率
df -h

# 查看目录大小
du -sh /var/log/*

# 找出最大的文件
find / -type f -size +500M -exec ls -lh {} \; 2>/dev/null | sort -k5 -rh | head -20

# 查看inode使用率（inode满了也会报 No space left on device）
df -i

5.5 磁盘性能测试

1
2
3
4
5
6


# 测试顺序读速度
sudo hdparm -Tt /dev/sda

# 生产磁盘不要直接用 dd 做写入基准。优先在隔离测试卷上使用 fio，
# 明确文件路径、容量、块大小、队列深度、读写比例、direct I/O 和运行时间，
# 并确认测试文件不会覆盖业务数据。不同参数的结果不能直接横向比较。

5.6 常见磁盘问题

1
2
3
4
5
6


磁盘空间满 → df -h 定位，然后 du -sh * 找大文件
inode 满 → df -i 检查，通常是大量小文件导致
I/O wait 高 → iostat -x 1 看 %util 和 await
某个进程疯狂写盘 → iotop -o 定位进程
日志文件太大 → 用 logrotate 管理日志轮转
删除文件空间未释放 → lsof | grep deleted 查看，重启占用进程释放

5.7 查找已删除但未释放空间的文件

1
2
3
4
5


# 查看已删除但被进程占用未释放的文件
lsof | grep deleted

# 查看指定进程打开的文件
lsof -p <PID>

六、网络排查

6.1 网络连通性

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


# 测试网络是否通
ping 8.8.8.8

# 测试指定端口是否通
telnet 192.168.1.100 8080
# 或
nc -zv 192.168.1.100 8080

# 测试到目标的网络路径和延迟
traceroute 8.8.8.8
# 或
mtr 8.8.8.8 # 持续版本的 traceroute（需安装）

6.2 mtr — 网络链路质量

1
2
3
4
5
6
7
8


# 持续探测到目标的每一跳
mtr --report baidu.com

# 关键指标：
# Loss% — 探测包未获响应的比例；中间路由器可能限速 ICMP，需看后续各跳和端到端结果
# Avg — 平均延迟
# Worst — 最差延迟
# StDev — 延迟波动（越大越不稳定）

6.3 网卡流量与错误

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


# 查看网卡流量
ip -s link show eth0

# 实时监控网卡流量（需安装）
iftop -i eth0

# 查看网卡统计信息（关注错误和丢包）
cat /proc/net/dev
# 关注：errors（错误数）、dropped（丢包数）

# 用 nload 看实时流量（需安装）
nload

6.4 TCP 连接统计

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


# 查看所有 TCP 连接状态统计
ss -ant | awk '{print $1}' | sort | uniq -c | sort -rn

# 常见状态：
# ESTABLISHED — 已建立的连接
# TIME_WAIT — 主动关闭方为处理迟到报文而保留的正常状态；数量多不等于故障
# CLOSE_WAIT — 等待应用关闭的连接（大量堆积说明应用没正确关闭连接）
# SYN_SENT — 正在建立连接（多说明连接慢或目标不可达）

# 查看连接数最多的 IP
ss -ant | grep ESTAB | awk '{print $5}' | cut -d: -f1 | sort | uniq -c | sort -rn | head -10

# 查看指定端口的连接数
ss -ant state established '( dport = :8080 or sport = :8080 )' | wc -l

6.5 sar — 网络历史统计

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 查看历史网络流量（需安装 sysstat）
sar -n DEV

# 查看今天的网络流量，每秒刷新
sar -n DEV 1

# 查看 TCP 统计
sar -n TCP 1

# 查看 SOCK 统计（socket 使用情况）
sar -n SOCK 1

6.6 抓包分析

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17


# 抓取指定网卡的所有包
sudo tcpdump -i eth0

# 抓取指定端口的包
sudo tcpdump -i eth0 port 8080

# 抓取指定 IP 的包
sudo tcpdump -i eth0 host 192.168.1.100

# 抓取并保存到文件（用 Wireshark 分析）
sudo tcpdump -i eth0 -w capture.pcap

# 抓取指定端口的前 100 个包，显示内容
sudo tcpdump -i eth0 port 8080 -c 100 -A

# 组合过滤
sudo tcpdump -i eth0 host 192.168.1.100 and port 8080 -nn

6.7 curl 测量接口耗时

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19


# 测量请求各阶段耗时
curl -o /dev/null -s -w "\
time_namelookup: %{time_namelookup}s\n\
time_connect: %{time_connect}s\n\
time_starttransfer: %{time_starttransfer}s\n\
time_total: %{time_total}s\n\
http_code: %{http_code}\n" https://example.com/api

# 各阶段含义：
# time_namelookup — DNS 解析耗时
# time_connect — TCP 连接耗时
# time_starttransfer — 首字节到达耗时（含服务端处理）
# time_total — 总耗时

# 判断依据：
# DNS 慢 → time_namelookup 高
# 网络慢 → time_connect 高
# 服务端慢 → time_starttransfer - time_connect 高
# 传输慢 → time_total - time_starttransfer 高

6.8 常见网络问题

1
2
3
4
5
6


连接超时 → 防火墙、路由、目标服务未启动
丢包严重 → mtr 逐跳排查，定位哪一跳开始丢包
TIME_WAIT 很多 → 先核对连接创建率、端口范围和失败指标；优先连接复用，不盲调内核参数
CLOSE_WAIT 过多 → 应用没正确关闭连接，检查代码
带宽跑满 → iftop 定位哪个连接占用带宽
DNS 解析慢 → 换 DNS 或配置 /etc/hosts

七、综合排查场景

场景1：服务器响应变慢

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


# 第一步：快速全局查看
top
# 看 load average、%us、%sy、wa、内存

# 第二步：确认方向
vmstat 1 5
# r 列（运行队列）、wa（I/O等待）、swpd（swap使用）

# 第三步：根据方向深入
# CPU 高 → ps aux --sort=-%cpu | head -10
# 内存高 → free -h && ps aux --sort=-%mem | head -10
# 磁盘慢 → iostat -x 1
# 网络慢 → curl 测耗时，iftop 看流量

场景2：CPU 使用率突然飙高

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


# 找到占用 CPU 最高的进程
ps aux --sort=-%cpu | head -5

# 看这个进程的线程情况
top -H -p <PID>

# 跟踪进程在做什么
strace -p <PID> -c

# 如果是 Java 应用
jstack <PID> > thread_dump.txt
# 或者
jcmd <PID> Thread.print

场景3：应用频繁 OOM

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15


# 查看 OOM 记录
dmesg | grep -i "killed process"

# 查看当前内存使用
free -h

# 找出内存占用最大的进程
ps aux --sort=-%mem | head -10

# 查看进程内存详情
pmap -x <PID>

# 如果是 Java 应用
jcmd <PID> GC.heap_info
jcmd <PID> GC.class_histogram | head -20

场景4：磁盘 I/O 导致应用变慢

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


# 确认 I/O wait
top # 看 wa 百分比
vmstat 1 5 # 看 wa 列和 b 列

# 查看哪个磁盘繁忙
iostat -x 1

# 找到疯狂读写磁盘的进程
sudo iotop -o

# 查看磁盘空间
df -h

场景5：网络请求慢

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


# 测试网络连通性和延迟
ping target-server
mtr target-server

# 测量接口各阶段耗时
curl -o /dev/null -s -w "DNS: %{time_namelookup}s\nConnect: %{time_connect}s\nFirstByte: %{time_starttransfer}s\nTotal: %{time_total}s\n" http://target-server/api

# 查看连接状态
ss -ant | awk '{print $1}' | sort | uniq -c | sort -rn

# 抓包分析
sudo tcpdump -i eth0 port 8080 -nn -c 100

八、常用工具速查

按场景选工具

场景	首选命令	辅助命令
快速全局查看	top / htop	vmstat、uptime
CPU 高	ps、top -H	strace、perf、pidstat
内存高	free、ps	pmap、slabtop
磁盘慢	iostat -x	iotop、pidstat -d
网络慢	ping、mtr	curl、iftop、tcpdump
查看进程详情	/proc/PID/*	pmap、lsof
查看系统日志	dmesg	journalctl、/var/log/*

工具安装

1
2
3
4
5
6
7


# Fedora / 当前 RHEL 系发行版
sudo dnf install -y sysstat iotop htop iftop nload mtr

# Ubuntu / Debian
sudo apt install -y sysstat iotop htop iftop nload mtr-tiny

# sysstat 包含：iostat、mpstat、pidstat、sar

Linux 命令速查手册

Sat, 14 Sep 2024 10:00:00 +0800

写在前面

本文整理了日常开发和运维中最常用的 Linux 命令，涵盖参数说明与实际示例，方便随时查阅。每个命令都力求实用，避免罗列用不到的冷门参数。

一、文件与目录

1.1 ls — 列出目录内容

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23


# 列出当前目录文件
ls

# 显示详细信息（权限、大小、时间）
ls -l

# 显示隐藏文件（以 . 开头的文件）
ls -a

# 按时间倒序排列（最新的在前）
ls -lt

# 按文件大小倒序排列
ls -lS

# 人类可读的文件大小（KB、MB、GB）
ls -lh

# 只显示目录名，不显示内容
ls -d */

# 递归列出所有子目录
ls -R

1.2 cd — 切换目录

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


# 切换到指定目录
cd /home/user/project

# 切换到上一级目录
cd ..

# 切换到用户主目录
cd ~
cd

# 切换到上一次所在的目录
cd -

1.3 pwd — 显示当前目录

1
2


# 显示当前所在目录的完整路径
pwd

1.4 mkdir — 创建目录

1
2
3
4
5
6
7
8


# 创建目录
mkdir my-folder

# 递归创建多级目录
mkdir -p project/src/main/java

# 创建时指定权限
mkdir -m 755 my-folder

1.5 cp — 复制

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


# 复制文件
cp file.txt backup.txt

# 复制目录（递归）
cp -r my-folder my-folder-backup

# 复制前确认是否覆盖
cp -i file.txt /target/

# 保持文件属性（权限、时间戳等）
cp -p file.txt /target/

# 显示复制过程
cp -rv my-folder /target/

1.6 mv — 移动/重命名

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 重命名文件
mv old-name.txt new-name.txt

# 移动文件到目录
mv file.txt /home/user/

# 移动目录
mv my-folder /home/user/

# 移动前确认是否覆盖
mv -i file.txt /target/

1.7 rm — 删除

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


# 删除文件
rm file.txt

# 删除前确认
rm -i file.txt

# 强制删除（不提示确认）
rm -f file.txt

# 递归删除目录及其内容
rm -r my-folder

# 强制递归删除目录（谨慎使用）
rm -rf my-folder

注意：rm -rf 不可恢复，使用前确认路径正确。千万不要执行 rm -rf /。

1.8 touch — 创建空文件/更新时间戳

1
2
3
4
5
6
7
8


# 创建空文件
touch newfile.txt

# 同时创建多个文件
touch file1.txt file2.txt file3.txt

# 更新文件的修改时间（文件已存在时不改变内容）
touch existing-file.txt

1.9 ln — 创建链接

1
2
3
4
5
6
7
8


# 创建软链接（类似快捷方式）
ln -s /usr/local/java/jdk-17 java17

# 创建硬链接（共享同一个 inode）
ln original.txt hardlink.txt

# 查看链接指向
ls -l java17

软链接可以跨文件系统，删源文件后链接失效；硬链接不能跨文件系统，删源文件后仍可访问。

1.10 find — 查找文件

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25


# 按文件名查找
find /home -name "*.log"

# 按文件名查找（不区分大小写）
find /home -iname "*.JPG"

# 按类型查找（f=文件，d=目录，l=链接）
find /var -type f -name "*.conf"
find /home -type d -name "project"

# 按大小查找（大于100MB的文件）
find / -type f -size +100M

# 按修改时间查找（7天内修改过的文件）
find /home -type f -mtime -7

# 按权限查找
find /home -type f -perm 755

# 先预览 7 天前的日志；确认范围后再在明确目录内执行删除
find /var/log/my-app -type f -name "*.log" -mtime +7 -print
# find /var/log/my-app -type f -name "*.log" -mtime +7 -delete

# 查找并执行命令（对结果执行 ls -l）
find /home -name "*.txt" -exec ls -l {} \;

1.11 tree — 树形显示目录结构

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 显示目录树
tree

# 只显示目录，不显示文件
tree -d

# 指定显示深度
tree -L 2

# 显示文件大小
tree -h

二、文件查看与编辑

2.1 cat — 查看文件内容

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 查看文件全部内容
cat file.txt

# 显示行号
cat -n file.txt

# 合并多个文件
cat file1.txt file2.txt > merged.txt

# 追加内容到文件
cat file1.txt >> file2.txt

2.2 head — 查看文件开头

1
2
3
4
5
6
7
8


# 查看前10行（默认）
head file.txt

# 查看前20行
head -n 20 file.txt

# 查看前1KB内容
head -c 1024 file.txt

2.3 tail — 查看文件末尾

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


# 查看最后10行（默认）
tail file.txt

# 查看最后50行
tail -n 50 file.txt

# 实时查看日志（最常用）
tail -f app.log

# 实时查看并显示行号
tail -fn 100 app.log

# 从第100行开始显示
tail -n +100 file.txt

2.4 less — 分页查看

1
2
3
4
5


# 分页查看大文件
less large-file.log

# 带行号查看
less -N file.txt

less 内操作：空格/b 翻页，/ 搜索，q 退出，G 跳到末尾，gg 跳到开头。

2.5 grep — 文本搜索

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29


# 搜索包含关键词的行
grep "ERROR" app.log

# 不区分大小写搜索
grep -i "error" app.log

# 显示行号
grep -n "ERROR" app.log

# 显示匹配行的前后各3行（上下文）
grep -C 3 "ERROR" app.log

# 只显示匹配的文件名
grep -l "ERROR" *.log

# 递归搜索目录下所有文件
grep -r "ERROR" /var/log/

# 反向搜索（不包含关键词的行）
grep -v "DEBUG" app.log

# 统计匹配行数
grep -c "ERROR" app.log

# 使用正则表达式
grep -E "ERROR|WARN" app.log

# 只匹配完整单词
grep -w "error" app.log

2.6 wc — 统计

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 统计行数
wc -l file.txt

# 统计单词数
wc -w file.txt

# 统计字节数
wc -c file.txt

# 统计文件行数（配合 find 使用）
find . -name "*.java" -print0 | xargs -0 -r wc -l

2.7 sort — 排序

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


# 默认按字母升序
sort file.txt

# 按数字大小排序
sort -n numbers.txt

# 倒序排列
sort -r file.txt

# 按第2列排序
sort -k2 file.txt

# 去重排序
sort -u file.txt

2.8 uniq — 去重

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 去除连续重复行（需先排序）
sort file.txt | uniq

# 统计每行出现的次数
sort file.txt | uniq -c

# 只显示重复的行
sort file.txt | uniq -d

# 只显示不重复的行
sort file.txt | uniq -u

2.9 awk — 文本处理

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


# 打印第1列
awk '{print $1}' file.txt

# 打印第1列和第3列
awk '{print $1, $3}' file.txt

# 指定分隔符
awk -F: '{print $1}' /etc/passwd

# 按条件过滤（第3列大于100）
awk '$3 > 100 {print $0}' file.txt

# 统计文件总行数
awk 'END {print NR}' file.txt

2.10 sed — 流编辑器

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


# 替换每行第一个匹配
sed 's/old/new/' file.txt

# 替换所有匹配
sed 's/old/new/g' file.txt

# 删除匹配行
sed '/^#/d' file.txt

# 显示指定行（第10到20行）
sed -n '10,20p' file.txt

# 直接修改文件（不加 -i 只输出到终端）
sed -i 's/old/new/g' file.txt

三、权限与用户

3.1 chmod — 修改权限

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15


# 给所有者添加执行权限
chmod u+x script.sh

# 设置具体权限（所有者读写执行，组读执行，其他人读执行）
chmod 755 script.sh

# 分别设置目录和普通文件权限（先在测试目录验证）
find /var/www/example -type d -exec chmod 755 {} +
find /var/www/example -type f -exec chmod 644 {} +

# 常用权限值
# 755 — 所有者全权限，其他读和执行
# 644 — 所有者读写，其他只读
# 600 — 只有所有者能读写
# 777 — 所有人全权限（不推荐在生产环境使用）

3.2 chown — 修改所有者

1
2
3
4
5
6
7
8


# 修改文件所有者
chown user file.txt

# 修改文件所有者和所属组
chown user:group file.txt

# 递归修改目录
chown -R user:group /var/www/

3.3 sudo — 以管理员权限执行

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 以 root 权限执行命令
sudo command

# 以指定用户执行
sudo -u username command

# 切换到 root 用户
sudo su -

# 编辑需要 root 权限的文件
sudo vim /etc/nginx/nginx.conf

3.4 用户管理

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23


# 创建用户
useradd username

# 创建用户并创建主目录
useradd -m username

# 设置用户密码
passwd username

# 删除用户
userdel username

# 删除用户及其主目录
userdel -r username

# 查看当前用户
whoami

# 查看用户信息
id username

# 切换用户
su - username

3.5 用户组管理

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 创建用户组
groupadd devgroup

# 将用户添加到组
usermod -aG devgroup username

# 查看用户所属的组
groups username

# 删除用户组
groupdel devgroup

四、进程管理

4.1 ps — 查看进程

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20


# 查看当前终端的进程
ps

# 查看所有进程（常用）
ps aux

# 查看所有进程（System V 风格）
ps -ef

# 查找指定进程
pgrep -a nginx

# 按内存使用排序（取前10）
ps aux --sort=-%mem | head -10

# 按CPU使用排序（取前10）
ps aux --sort=-%cpu | head -10

# 查看进程树
ps -ef --forest

4.2 top / htop — 实时监控

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


# 实时查看进程资源占用
top

# 按内存排序（进入 top 后按 M）
# 按CPU排序（进入 top 后按 P）
# 按进程ID排序（进入 top 后按 N）
# 退出（按 q）

# htop 是增强版（需安装），支持鼠标和快捷键
htop

4.3 kill — 终止进程

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


# 正常终止进程
kill 12345

# 强制终止进程
kill -9 12345

# 按名称终止进程
killall nginx

# 按名称模糊终止
pkill -f "java -jar app"

# 查看所有信号
kill -l

常用信号：15 (SIGTERM) 正常终止，9 (SIGKILL) 强制终止，1 (SIGHUP) 重新加载配置。

4.4 nohup — 后台运行

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 后台运行，输出到 nohup.out
nohup java -jar app.jar &

# 指定日志输出文件
nohup java -jar app.jar > app.log 2>&1 &

# 查看后台任务
jobs

# 将后台任务调到前台
fg %1

4.5 systemctl — 服务管理

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23


# 启动服务
sudo systemctl start nginx

# 停止服务
sudo systemctl stop nginx

# 重启服务
sudo systemctl restart nginx

# 重新加载配置（不中断服务）
sudo systemctl reload nginx

# 查看服务状态
sudo systemctl status nginx

# 设置开机自启
sudo systemctl enable nginx

# 取消开机自启
sudo systemctl disable nginx

# 查看所有已启动的服务
sudo systemctl list-units --type=service --state=running

五、网络

5.1 ip / ifconfig — 查看网络信息

1
2
3
4
5
6
7
8
9


# 查看所有网卡IP地址
ip addr
ip a

# 查看指定网卡
ip addr show eth0

# 老命令（部分系统仍可用）
ifconfig

5.2 ping — 测试网络连通性

1
2
3
4
5
6
7
8


# 测试是否可达
ping 8.8.8.8

# 指定次数（发4个包后停止）
ping -c 4 baidu.com

# 指定间隔（每2秒发一次）
ping -i 2 baidu.com

5.3 curl — HTTP 请求

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22


# GET 请求
curl https://example.com

# 只显示响应头
curl -I https://example.com

# POST 请求（JSON）
curl -X POST https://api.example.com/users \
 -H "Content-Type: application/json" \
 -d '{"name": "test"}'

# 下载文件
curl -O https://example.com/file.tar.gz

# 指定超时时间（秒）
curl --connect-timeout 5 --max-time 10 https://example.com

# 显示请求耗时
curl -o /dev/null -s -w "time_total: %{time_total}s\n" https://example.com

# 带认证
curl -u username:password https://api.example.com

5.4 wget — 下载文件

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 下载文件
wget https://example.com/file.tar.gz

# 指定保存文件名
wget -O myfile.tar.gz https://example.com/file.tar.gz

# 后台下载
wget -b https://example.com/large-file.zip

# 断点续传
wget -c https://example.com/large-file.zip

5.5 netstat / ss — 查看端口与连接

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


# 查看所有监听端口
ss -tlnp

# 查看指定端口占用
ss -tlnp | grep 8080

# 查看所有网络连接
ss -an

# 老命令（部分系统仍可用）
netstat -tlnp
netstat -an | grep 8080

5.6 nslookup / dig — DNS 查询

1
2
3
4
5
6
7
8


# 查询域名解析
nslookup baidu.com

# 查询指定DNS服务器
nslookup baidu.com 8.8.8.8

# 详细DNS查询
dig baidu.com

5.7 防火墙（firewalld）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17


# 查看防火墙状态
sudo firewall-cmd --state

# 开放端口
sudo firewall-cmd --add-port=8080/tcp --permanent

# 开放服务
sudo firewall-cmd --add-service=http --permanent

# 重新加载配置
sudo firewall-cmd --reload

# 查看已开放的端口
sudo firewall-cmd --list-ports

# 查看所有规则
sudo firewall-cmd --list-all

六、磁盘与内存

6.1 df — 查看磁盘空间

1
2
3
4
5
6
7
8


# 查看所有磁盘使用情况
df -h

# 查看指定目录所在磁盘
df -h /home

# 显示文件系统类型
df -T

6.2 du — 查看目录大小

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 查看当前目录总大小
du -sh

# 查看各子目录大小
du -sh *

# 查看指定目录大小
du -sh /var/log

# 按大小排序（找出最大的目录）
du -sh * | sort -rh | head -10

6.3 free — 查看内存使用

1
2
3
4
5
6
7
8


# 查看内存使用（人类可读）
free -h

# 每隔2秒刷新一次
free -h -s 2

# 以MB为单位显示
free -m

6.4 mount / umount — 挂载磁盘

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 查看已挂载的磁盘
mount

# 挂载磁盘到目录
sudo mount /dev/sdb1 /data

# 卸载磁盘
sudo umount /data

# 查看可用磁盘
lsblk

七、压缩与解压

7.1 tar — 打包与解包

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21


# 打包并gzip压缩
tar -czf archive.tar.gz folder/

# 打包并gzip压缩（显示过程）
tar -czvf archive.tar.gz folder/

# 解压 .tar.gz
tar -xzf archive.tar.gz

# 解压到指定目录
tar -xzf archive.tar.gz -C /target/

# 解压 .tar.bz2
tar -xjf archive.tar.bz2

# 只查看压缩包内容（不解压）
tar -tzf archive.tar.gz

# 追加文件只适用于未压缩的 tar 包
tar -rf archive.tar newfile.txt
# `.tar.gz` / `.tar.bz2` 不能直接用 `-r` 追加，需要重新创建压缩包

参数记忆：-c 创建，-x 解压，-t 查看，-z gzip，-j bzip2，-v 显示过程，-f 指定文件名。

7.2 zip / unzip

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


# 压缩文件
zip archive.zip file1.txt file2.txt

# 压缩目录
zip -r archive.zip my-folder/

# 解压
unzip archive.zip

# 解压到指定目录
unzip archive.zip -d /target/

# 查看压缩包内容
unzip -l archive.zip

八、系统信息

8.1 系统基础信息

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22


# 查看系统版本
cat /etc/os-release

# 查看内核版本
uname -r

# 查看全部系统信息
uname -a

# 查看主机名
hostname

# 查看系统运行时间
uptime

# 查看CPU信息
lscpu
# 或
cat /proc/cpuinfo

# 查看内存信息
cat /proc/meminfo

8.2 环境变量

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


# 查看所有环境变量
env

# 查看指定环境变量
echo $PATH
echo $JAVA_HOME

# 设置环境变量（当前会话生效）
export MY_VAR="hello"

# 永久生效（写入配置文件）
echo 'export JAVA_HOME=/usr/local/java/jdk-17' >> ~/.bashrc
source ~/.bashrc

九、远程与传输

9.1 ssh — 远程连接

1
2
3
4
5
6
7
8


# 连接远程服务器
ssh user@192.168.1.100

# 指定端口
ssh -p 2222 user@192.168.1.100

# 使用密钥登录
ssh -i ~/.ssh/my-key.pem user@192.168.1.100

9.2 scp — 远程复制

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


# 上传本地文件到远程
scp file.txt user@192.168.1.100:/home/user/

# 上传目录到远程
scp -r my-folder user@192.168.1.100:/home/user/

# 从远程下载文件
scp user@192.168.1.100:/home/user/file.txt ./

# 从远程下载目录
scp -r user@192.168.1.100:/home/user/my-folder ./

# 指定端口
scp -P 2222 file.txt user@192.168.1.100:/home/user/

9.3 rsync — 高效同步

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 同步本地目录到远程
rsync -avz my-folder/ user@192.168.1.100:/home/user/my-folder/

# 同步远程目录到本地
rsync -avz user@192.168.1.100:/home/user/my-folder/ ./my-folder/

# 显示传输进度
rsync -avz --progress my-folder/ user@192.168.1.100:/home/user/my-folder/

# 删除目标端多余的文件（保持完全一致）
rsync -avz --delete my-folder/ user@192.168.1.100:/home/user/my-folder/

rsync 只传输差异部分，比 scp 快很多，适合大文件和频繁同步。

十、管道与重定向

10.1 管道 `|`

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 查找进程
ps aux | grep nginx

# 统计日志中ERROR出现次数
grep "ERROR" app.log | wc -l

# 查找并排序
cat file.txt | sort | uniq -c | sort -rn

# 查看占用80端口的进程
ss -tlnp | grep :80

10.2 重定向

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17


# 输出重定向到文件（覆盖）
echo "hello" > file.txt

# 输出追加重定向
echo "hello" >> file.txt

# 错误输出重定向
command 2> error.log

# 标准输出和错误都重定向
command > all.log 2>&1

# 丢弃所有输出
command > /dev/null 2>&1

# 输入重定向
command < input.txt

十一、常用组合命令

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20


# 查找占用指定 TCP 监听端口的进程（先确认，再单独发送 SIGTERM）
sudo ss -ltnp 'sport = :8080'

# 统计代码行数（按文件类型）
find . -name "*.java" -print0 | xargs -0 -r wc -l | tail -1

# 查看匹配命令行的进程；核对 PID 后优先发送 SIGTERM
pgrep -af 'java -jar'

# 实时监控日志中的关键词
tail -f app.log | grep --color "ERROR"

# 查找大文件并排序
sudo find / -xdev -type f -size +100M -printf '%s\t%p\n' 2>/dev/null | sort -nr | head

# 统计 Nginx 访问日志中各 IP 的访问次数（取前10）
awk '{print $1}' access.log | sort | uniq -c | sort -rn | head -10

# 批量替换文件内容
sed -i.bak 's/old-domain.com/new-domain.com/g' ./*.conf

Git 命令速查手册

Tue, 10 Sep 2024 10:00:00 +0800

Git 是什么

Git 是一个分布式版本控制系统。它用提交记录项目在不同时刻的完整快照，让开发者能够比较变化、创建分支、合并协作，并在误操作后找回历史。所谓“分布式”，是指一次完整克隆通常包含仓库历史和分支信息；即使暂时没有网络，也能提交、切换分支和查看历史。

Git 本身负责版本历史，GitHub、GitLab、Gitee 等平台则提供远程托管、权限管理、代码评审和 CI/CD。会使用 Git 不等于只能依赖某个托管平台。

如果想进一步理解这些命令背后的存储机制，可以阅读《深入理解 .git 目录：Git 如何存储提交、分支与暂存区》。

Git 的四个区域

理解命令前，先记住文件会在四个区域之间流动：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


工作区（Working Tree）
 │ git add
 ↓
暂存区（Index / Staging Area）
 │ git commit
 ↓
本地仓库（Local Repository）
 │ git push
 ↓
远程仓库（Remote Repository）

工作区：实际编辑的文件；
暂存区：下一次提交准备包含的快照；
本地仓库：保存在 .git 中的对象、引用和历史；
远程仓库：用于交换提交的另一个仓库，origin 只是常见的远程名称。

git diff 默认比较工作区与暂存区，git diff --staged 比较暂存区与 HEAD，git status 则概括各区域之间的差异。

提交、分支与 HEAD

Git 的核心对象包括 Blob（文件内容）、Tree（目录快照）、Commit（一次提交）和 Tag（标签）。提交保存指向 Tree 和父提交的关系，并由内容计算对象 ID。

分支本质上是一个可移动引用，指向某次提交；HEAD 通常指向当前分支。创建分支不会复制一份代码，只是新增一个引用。提交后，当前分支向新提交移动。

文件的三种状态

未跟踪（Untracked）：Git 尚未纳入版本管理；
已修改（Modified）：已跟踪文件在工作区发生变化；
已暂存（Staged）：变化已经进入暂存区，等待提交。

下文按日常工作顺序整理命令。涉及 reset --hard、clean -fd、强制推送等会丢失数据的操作，执行前务必先用状态或预览命令确认范围。

一、基础操作

1.1 git init — 初始化仓库

1
2
3
4
5


# 在当前目录初始化
git init

# 初始化到指定目录
git init my-project

1.2 git clone — 克隆远程仓库

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 克隆到当前目录下的同名文件夹
git clone https://github.com/user/repo.git

# 克隆到指定目录名
git clone https://github.com/user/repo.git my-folder

# 克隆指定分支
git clone -b main https://github.com/user/repo.git

# 浅克隆（只取最近一次提交，大仓库速度快）
git clone --depth=1 https://github.com/user/repo.git

1.3 git add — 添加到暂存区

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


# 添加指定文件
git add README.md

# 添加多个文件
git add file1.md file2.md

# 添加当前目录下所有变更
git add .

# 添加所有变更（包括已删除的文件）
git add -A

# 交互式添加（按块选择要暂存的内容）
git add -p

1.4 git commit — 提交

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


# 不带参数会打开编辑器让你写提交信息
git commit

# -m 直接指定提交信息（message）
git commit -m "feat: 添加用户登录功能"

# -a 提交所有已跟踪文件的修改（跳过 git add）
git commit -a -m "fix: 修复空指针异常"

# --amend 修改上一次提交（未推送到远程时使用）
git commit --amend -m "feat: 添加用户登录和注册功能"

# --allow-empty 空提交（用于触发 CI 或占位）
git commit --allow-empty -m "chore: 触发部署"

提交信息建议遵循 Conventional Commits 约定（见第九节）：用 feat / fix / docs 等前缀，便于 git log 阅读与自动生成 changelog。

--amend 会用新提交替换上一次提交（改写历史），和 rebase 同理：已推送的提交不要 amend ，否则别人的仓库会和你对不上；它只适合修正还没推送的本地提交。

1.5 git status — 查看状态

1
2
3
4
5
6
7
8


# 查看工作区和暂存区状态
git status

# 简短输出（一行一个文件）
git status -s

# 显示被忽略的文件
git status --ignored

状态标记说明：

标记	含义
`??`	未跟踪的新文件
`A`	新添加到暂存区
`M`	已修改
`D`	已删除
`R`	已重命名
`!!`	被忽略的文件

左侧为暂存区状态，右侧为工作区状态。例如 MM 表示暂存区和工作区都有修改。

1.6 git log — 查看提交历史

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26


# 查看完整提交历史
git log

# 单行显示
git log --oneline

# 显示最近 5 条
git log --oneline -5

# 图形化显示分支合并历史
git log --oneline --graph --all

# 显示每次提交的文件变更统计
git log --stat

# 显示指定文件的提交历史
git log -- path/to/file

# 按作者筛选
git log --author="张三"

# 按时间筛选
git log --since="2026-01-01" --until="2026-03-31"

# 按提交信息搜索
git log --grep="修复"

1.7 git rm / git mv — 删除与移动文件

1
2
3
4
5
6
7
8


# 从工作区和暂存区删除已跟踪文件
git rm old-file.md

# 只停止跟踪，保留工作区文件（常用于误提交的配置文件）
git rm --cached appsettings.local.json

# 移动或重命名文件，并暂存这次变化
git mv old-name.md new-name.md

Git 不会永久存储“重命名”这一动作，而是在比较内容时根据相似度识别重命名。

二、分支管理

2.1 git branch — 分支操作

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20


# 查看所有本地分支
git branch

# 查看所有分支（含远程）
git branch -a

# 创建新分支（不切换）
git branch feature/login

# 删除已合并的分支
git branch -d feature/login

# 强制删除分支（无论是否合并）
git branch -D feature/login

# 重命名当前分支
git branch -m new-branch-name

# 重命名指定分支
git branch -m old-name new-name

2.2 git checkout / switch — 切换分支

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


# 切换到已有分支
git checkout main

# 创建并切换到新分支
git checkout -b feature/login

# 切换到上一个分支
git checkout -

# Git 2.23+ 推荐用 switch 替代
git switch main
git switch -c feature/login # 创建并切换
git switch - # 切换到上一个分支

2.3 git merge — 合并分支

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 将 feature 分支合并到当前分支
git merge feature/login

# 合并时不使用快进（保留分支历史）
git merge --no-ff feature/login

# 只取另一个分支中指定文件的版本（这不是 merge）
git restore --source=feature/login -- path/to/file

# 取消正在进行的合并
git merge --abort

merge 把指定分支的提交并入当前分支，结果有两种：

快进合并（fast-forward） :当前分支是另一分支的直接祖先（中间没有新提交）时，Git 只把指针前移，不产生新提交，历史保持直线。
三方合并 :两条分支各有新提交时，Git 生成一个合并提交（有两个父提交）把两条线汇合，历史是非线性的。

--no-ff 强制生成合并提交，即使能快进——目的是保留"这里曾有一条特性分支"的拓扑结构，便于事后追溯。

2.4 git rebase — 变基

rebase 是"换底"：把当前分支的提交一个个摘下来，重新应用到目标分支的最新提交之上。效果是把当前分支的起点挪到目标分支顶端，得到一条线性历史。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 将当前分支变基到 main
git rebase main

# 交互式变基（修改最近 3 次提交）
git rebase -i HEAD~3

# 取消正在进行的变基
git rebase --abort

# 变基遇到冲突解决后继续
git rebase --continue

同样是把 feature 合进 main，merge 和 rebase 在图上长这样（假设 feature 有 A、B、C 三个提交，main 在此期间也前进了）：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


修改前：
 A---B---C feature
 /
 D---E---F---G main

git merge（在 main 上执行 git merge feature）：
 A---B---C feature
 / \
 D---E---F---G---M main ← M 是合并提交（父：C 和 G）

git rebase（在 feature 上执行 git rebase main）：
 A'--B'--C' feature ← 提交被重写，接在 G 之后
 /
 D---E---F---G main

关键区别：

merge 保留两条分支各自的历史，生成合并提交，拓扑是非线性的；
rebase 重写当前分支的提交（产生新的提交 ID），让它们线性地接在目标分支之后，看起来像从未分叉。

黄金法则：已经推送到远程、可能被他人拉取的提交，不要 rebase ——rebase 会改写历史，导致别人的仓库和你对不上。安全用法是只 rebase 还在自己本地的提交，例如在 feature 分支上 git rebase main 把 main 的最新改动垫到自己提交之下，再合并回 main，主线就是干净的线性历史。

三、远程协作

3.1 git remote — 远程仓库管理

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


# 查看远程仓库名
git remote

# 查看远程仓库详细信息（URL）
git remote -v

# 添加远程仓库
git remote add origin https://github.com/user/repo.git

# 修改远程仓库地址
git remote set-url origin https://github.com/user/new-repo.git

# 删除远程仓库
git remote remove origin

3.2 git fetch — 获取远程更新

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 获取所有远程分支的更新（不合并）
git fetch origin

# 获取指定分支
git fetch origin main

# 获取所有远程仓库的更新
git fetch --all

# 清理远程已经删除的跟踪分支
git fetch --prune

3.3 git pull — 拉取并合并

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 拉取当前分支的远程更新（使用默认远程和分支）
git pull

# 拉取指定远程分支的更新并合并
git pull origin main

# 使用 rebase 方式拉取（避免产生合并提交）
git pull --rebase origin main

# 拉取所有远程分支
git pull --all

fetch vs pull :fetch 只把远程的提交下载到本地，不动你的工作区和当前分支，是只读、安全的；pull = fetch + 合并（默认用 merge，加 --rebase 则用 rebase），会直接更新当前分支。想先看看远程有什么再决定怎么处理，用 git fetch 再手动 merge/rebase；确定要直接更新当前分支，用 git pull。

3.4 git push — 推送到远程

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23


# 推送到当前分支的跟踪远程（使用默认配置）
git push

# 推送当前分支到指定远程分支
git push origin main

# 首次推送并建立跟踪关系
git push -u origin feature/login

# 推送所有本地分支
git push --all origin

# 推送标签
git push origin v1.0.0

# 推送所有标签
git push --tags

# 删除远程分支
git push origin --delete feature/login

# 安全强制推送：远端已被他人更新时拒绝覆盖
git push --force-with-lease

重写已经推送的历史前，应先与协作者确认。优先使用 --force-with-lease，不要直接使用 --force。

四、撤销与回退

4.1 git reset — 回退提交

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


# 回退到上一个提交（默认 --mixed 模式）
git reset HEAD~1

# 软回退：保留修改在暂存区（撤销 commit，不撤销 add）
git reset --soft HEAD~1
git reset --mixed HEAD~1

# 硬回退：丢弃所有修改（谨慎使用）
git reset --hard HEAD~1

# 回退到指定提交
git reset --soft abc1234

三种模式都把 HEAD 往回移，区别在"剩下的改动放哪"：

模式	工作区	暂存区	用途
`--soft`	保留	保留（改动都还在暂存区）	只撤销 commit，改动和 `add` 都留着，改完信息重新提交
`--mixed`（默认）	保留	清空（改动退回工作区，需重新 `add`）	撤销 commit 且撤销 `add`，重新挑选要提交的内容
`--hard`	丢弃	丢弃	彻底放弃这些改动（不可逆，谨慎）

HEAD~1 表示上一个提交，HEAD~3 表示往上三个提交。

4.2 git revert — 撤销提交（生成新提交）

1
2
3
4
5
6
7
8
9


# 撤销指定提交（会生成一个新的撤销提交）
git revert abc1234

# 撤销最近一次提交
git revert HEAD

# 撤销多个提交（不自动提交，最后一起提交）
git revert --no-commit HEAD~3..HEAD
git commit -m "revert: 撤销最近三次提交"

reset vs revert：reset 是"回退历史"，适合未推送的提交；revert 是"新增一个撤销提交"，适合已推送的提交，不影响他人。

4.3 git checkout — 恢复文件

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 恢复工作区指定文件（丢弃未暂存的修改）
git checkout -- file.md

# Git 2.23+ 推荐用 restore 替代
git restore file.md

# 从暂存区恢复文件到工作区
git restore --staged file.md

# 恢复某个文件到指定提交的版本
git restore --source=abc1234 file.md

4.4 git stash — 暂存工作区

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23


# 暂存当前修改
git stash

# 暂存时附加说明
git stash save "开发到一半的功能"

# 暂存时包含未跟踪的文件
git stash -u

# 查看暂存列表
git stash list

# 恢复最近一次暂存
git stash pop

# 恢复指定暂存（不删除记录）
git stash apply stash@{1}

# 删除指定暂存
git stash drop stash@{0}

# 清空所有暂存
git stash clear

git stash push -m "说明" 是目前更明确的写法；默认不会包含未跟踪文件，需要使用 -u。

五、标签与发布

5.1 git tag — 标签管理

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20


# 查看所有标签
git tag

# 创建轻量标签
git tag v1.0.0

# 创建附注标签（推荐，包含作者、日期、说明）
git tag -a v1.0.0 -m "正式版本 1.0.0"

# 给指定提交打标签
git tag -a v0.9.0 abc1234 -m "补打标签"

# 查看标签详情
git show v1.0.0

# 删除本地标签
git tag -d v1.0.0

# 删除远程标签
git push origin --delete v1.0.0

六、查看与搜索

6.1 git show — 查看对象与提交

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 查看最新提交及差异
git show

# 查看指定提交
git show abc1234

# 查看某次提交中的文件内容
git show abc1234:path/to/file.md

# 查看标签指向的对象
git show v1.0.0

6.2 git diff — 查看差异

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17


# 查看工作区与暂存区的差异
git diff

# 查看暂存区与最新提交的差异
git diff --staged

# 查看两个提交之间的差异
git diff abc1234 def5678

# 查看指定文件的差异
git diff -- path/to/file

# 只显示变更的文件名
git diff --name-only

# 显示差异统计（增删行数）
git diff --stat

6.3 git blame — 查看文件每行的修改者

1
2
3
4
5
6
7
8


# 查看文件每行的最后修改者和提交
git blame README.md

# 指定行范围（第 10 到 30 行）
git blame -L 10,30 README.md

# 只显示邮箱
git blame -e README.md

6.4 git grep — 在仓库中搜索

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 在所有已跟踪文件中搜索关键词
git grep "TODO"

# 显示行号
git grep -n "TODO"

# 只显示文件名
git grep -l "TODO"

# 在指定提交中搜索
git grep "TODO" abc1234

七、实用技巧

7.1 git cherry-pick — 摘取提交

1
2
3
4
5
6
7
8


# 将指定提交应用到当前分支
git cherry-pick abc1234

# 摘取多个提交
git cherry-pick abc1234 def5678

# 摘取提交但不自动提交（方便修改后再提交）
git cherry-pick -n abc1234

7.2 git bisect — 二分查找问题提交

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


# 开始二分查找
git bisect start

# 标记当前提交有问题
git bisect bad

# 标记某个正常的提交
git bisect good v1.0.0

# Git 会自动切换到中间提交，测试后标记
git bisect good # 或 git bisect bad

# 找到问题提交后结束查找
git bisect reset

7.3 git reflog — 查看所有操作记录

1
2
3
4
5
6
7
8


# 查看所有操作记录（包括已删除的提交和分支切换）
git reflog

# 查看指定分支的操作记录
git reflog show feature/login

# 恢复误删的提交
git checkout abc1234

reflog 记录了 HEAD 的每一次移动，是误操作的救命稻草。

7.4 git worktree — 多分支同时工作

1
2
3
4
5
6
7
8


# 创建工作树（在同一仓库下同时工作在多个分支）
git worktree add ../hotfix-branch hotfix/urgent

# 查看所有工作树
git worktree list

# 删除工作树
git worktree remove ../hotfix-branch

7.5 常用配置

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22


# 设置用户名和邮箱
git config --global user.name "张三"
git config --global user.email "zhangsan@example.com"

# 设置默认分支名为 main
git config --global init.defaultBranch main

# 设置默认编辑器
git config --global core.editor "code --wait"

# 设置别名
git config --global alias.st status
git config --global alias.co checkout
git config --global alias.br branch
git config --global alias.ci commit
git config --global alias.lg "log --oneline --graph --all"

# 查看所有配置
git config --list

# 存储凭据（避免每次输入密码）
git config --global credential.helper manager

八、仓库迁移与高级操作

8.1 git bundle — 离线迁移与备份仓库历史

git bundle 把 Git 对象与引用打包成单个文件，适合隔离网络之间传输仓库，也可以制作可验证的历史备份。Bundle 可以被 clone 和 fetch 读取，但不能像普通远程仓库那样直接 push 写入。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17


# 创建包含所有可达引用的完整 Bundle
git bundle create repo-backup.bundle --all

# 检查 Bundle 格式和前置提交是否满足
git bundle verify repo-backup.bundle

# 查看 Bundle 包含哪些分支或标签
git bundle list-heads repo-backup.bundle

# 从 Bundle 克隆仓库
git clone repo-backup.bundle restored-repo

# 从 Bundle 获取 main 分支到当前仓库
git fetch repo-backup.bundle main:refs/remotes/bundle/main

# 创建 main 分支在 v1.0.0 之后的增量 Bundle
git bundle create update.bundle v1.0.0..main

完整 Bundle 只包含引用可达的提交和 Git 对象，不包含工作区未提交修改、暂存区、每仓库配置、Hooks 等本地状态。增量 Bundle 依赖接收方已经具有范围左侧的前置提交，接收前应执行 git bundle verify。

8.2 git submodule — 管理子模块

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


# 添加另一个仓库作为子模块
git submodule add https://github.com/user/theme.git themes/theme

# 克隆后初始化并检出子模块
git submodule update --init --recursive

# 克隆时直接递归获取子模块
git clone --recurse-submodules https://github.com/user/repo.git

# 按 .gitmodules 中配置的远程分支更新
git submodule update --remote --recursive

# 查看子模块状态
git submodule status --recursive

父仓库记录的是子模块提交 ID，不是子模块文件内容。更新后需要分别提交子模块自身的变化和父仓库中的指针变化。

8.3 git sparse-checkout — 只检出部分目录

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 启用 Cone 模式，适合按目录选择
git sparse-checkout init --cone

# 只检出两个目录
git sparse-checkout set src docs

# 再增加一个目录
git sparse-checkout add tools

# 关闭稀疏检出，恢复完整工作区
git sparse-checkout disable

稀疏检出主要减少工作区文件数量；若还希望减少首次下载的数据量，可在克隆时结合部分克隆参数，例如 git clone --filter=blob:none --sparse <url>。

8.4 git archive — 导出不含 Git 历史的源码包

1
2
3
4
5
6


# 将当前 HEAD 导出为 zip
git archive --format=zip --output=source.zip HEAD

# 导出指定标签，并给文件添加顶层目录
git archive --format=tar.gz --prefix=myapp-1.0.0/ \
 --output=myapp-1.0.0.tar.gz v1.0.0

archive 适合发布源码快照；需要保留提交历史或离线迁移时，应使用 bundle。

8.5 git clean — 清理未跟踪文件

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 预览将要删除的未跟踪文件，建议先执行
git clean -n

# 删除未跟踪文件
git clean -f

# 同时删除未跟踪目录
git clean -fd

# 连被 .gitignore 忽略的文件也删除（高风险）
git clean -fdx

git clean 删除的文件通常不能通过 Git 恢复。先用 -n 预览，并避免在目标范围不清楚时使用 -x。

8.6 git maintenance / fsck — 维护与完整性检查

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 立即运行仓库维护任务
git maintenance run

# 为当前仓库启用后台定期维护
git maintenance start

# 检查对象数据库的连通性和有效性
git fsck --full

# 查看松散对象与磁盘占用
git count-objects -vH

Git 通常会自动执行必要维护。除非正在诊断仓库体积或性能问题，否则不必频繁手动运行激进的清理命令。

九、提交信息规范

推荐使用 Conventional Commits（约定式提交）：用统一前缀让 git log 更易读，并为自动生成 changelog、计算语义化版本号提供依据。完整结构如下（header、body、footer 之间用空行分隔）：

1
2
3
4
5


<type>(<scope>)!: <description>

<body>

<footer(s)>

type（必填）：本次提交的性质，见下表；
scope（可选）：影响范围，如 auth、api；使用时须放在圆括号中，省略时连同括号一起省略；
!（可选）：紧跟 type 或 scope，表示破坏性变更（breaking change）；
description（必填）：简短描述；推荐使用祈使句，末尾不加句号；
body（可选）：解释为什么这么改；推荐每行不超过约 72 字符；
footer（可选，可有多个）：BREAKING CHANGE: 说明、Closes #123 关联 issue、Refs: 引用等。

常用 type：

类型	说明
`feat`	新功能
`fix`	修复 Bug
`docs`	文档变更
`style`	代码格式（不影响逻辑）
`refactor`	重构（不是新功能也不是修复）
`perf`	性能优化
`test`	增加或修改测试
`chore`	构建工具或辅助工具变更
`ci`	CI/CD 配置变更

单行示例：

1
2
3
4


git commit -m "feat(auth): 添加 OAuth2 第三方登录"
git commit -m "fix(api): 修复分页查询越界问题"
git commit -m "docs: 更新 API 接口文档"
git commit -m "revert: 撤销 abc1234 的登录改动"

带破坏性变更与正文、脚注的完整示例（多个 -m 各成一段，分别对应 header / body / footer）：

1
2
3
4
5


git commit \
 -m "feat(auth)!: 移除已废弃的旧版登录接口" \
 -m "旧接口自 v2.0 起弃用，本次彻底删除，调用方需改用 OAuth2。" \
 -m "BREAKING CHANGE: 删除 POST /login/legacy，迁移见 #42" \
 -m "Closes #40"

Conventional Commits 明确规定了 feat、fix 和破坏性变更的语义化版本影响：fix 对应 PATCH，feat 对应 MINOR，带 ! 或 BREAKING CHANGE: 的提交对应 MAJOR。表中的其他类型以及常见的 build（构建系统或外部依赖）、revert（撤销提交，本文 4.2 已使用）属于工具生态和团队实践中的惯例，可以自行扩展，但应在仓库内保持一致。

规范一旦推送就难改：提交信息在 commit 时写下，但真正的约束在推送之后——一旦进入远程共享历史，再改就要动 --amend / rebase，进而触发 1.4 的 amend 禁忌、2.4 的 rebase 黄金法则和 3.4 的 --force-with-lease。写的时候就写好，比推送后补救便宜得多。规范化的 type 还能让工具链自动派生价值：commitizen 引导填写、commitlint 校验、release-please / standard-version 按类型生成 changelog 与版本号。

参考资料

Hugo 命令速查手册

Mon, 02 Sep 2024 10:00:00 +0800

创建新网站

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


# 当前写法
hugo new project site-name

# 兼容写法
hugo new site site-name

# 强制创建到非空目录
hugo new project site-name --force

# 指定配置格式
hugo new project site-name --format yaml
hugo new project site-name --format json
hugo new project site-name --format toml

创建内容

1
2
3
4
5
6
7
8


# 使用 archetype 创建新文章（显式写 content 子命令，语义最清楚）
hugo new content posts/my-article.md

# 创建到子目录
hugo new content posts/category/my-article.md

# 指定内容类型
hugo new content --kind term posts/my-article.md

开发服务器

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22


# 启动开发服务器（默认 http://localhost:1313）
hugo server

# 包含草稿文章
hugo server --buildDrafts
hugo server -D

# 指定端口
hugo server --port 8080
hugo server -p 8080

# 禁用 Fast Render（完整重建）
hugo server --disableFastRender

# 绑定到所有网络接口（局域网访问）
hugo server --bind 0.0.0.0

# 查看草稿和未来日期的文章
hugo server --buildDrafts --buildFuture
hugo server -D -F

# 开发服务器默认监听项目文件变化，无需额外参数

构建网站

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24


# 构建到 public/ 目录
hugo

# 构建包含草稿
hugo --buildDrafts
hugo -D

# 删除目标目录中不属于本次构建的文件后构建
hugo --cleanDestinationDir

# 指定构建输出目录
hugo --destination /path/to/output
hugo -d /path/to/output

# 指定配置文件（--config 没有简写；-c 是 --contentDir 的简写，别混用）
hugo --config my-config.toml

# 指定主题
hugo --theme my-theme
hugo -t my-theme

# 指定 baseURL
hugo --baseURL https://example.com/
hugo -b https://example.com/

配置与查询

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


# 查看所有配置
hugo config

# 列出所有页面
hugo list all

# 列出所有草稿
hugo list drafts

# 列出所有过期页面
hugo list expired

# 列出所有未来发布页面
hugo list future

内容管理

1
2
3
4
5
6


# 清理 Hugo Module 文件缓存（只针对 Hugo Modules）
hugo mod clean

# 查看模块依赖和校验模块
hugo mod graph
hugo mod verify

实用选项

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19


# 显示调试信息
hugo --logLevel debug

# 安静模式（减少输出；--quiet 没有简写）
hugo --quiet

# 显示版本信息
hugo version

# 显示帮助
hugo help

# 指定源目录
hugo --source /path/to/source
hugo -s /path/to/source

# 指定环境
hugo --environment production
hugo -e production

快捷操作

1
2
3
4
5
6
7
8


# 完整渲染模式启动开发服务器
hugo server --disableFastRender

# 创建并启动编辑
hugo new content posts/article.md && code content/posts/article.md

# 生产式构建（按项目约定决定是否包含未来日期内容）
hugo --minify --buildFuture --cleanDestinationDir

常见问题

1
2
3
4
5


# 查看所有页面及其状态
hugo list all

# 查看特定页面信息（rg 可替换为 grep）
hugo list all | rg "页面名称"

常用简写对照

简写	全称
`-D`	`--buildDrafts`
`-F`	`--buildFuture`
`-p`	`--port`（`hugo server` 的旗标）
`-d`	`--destination`
`-t`	`--theme`
`-c`	`--contentDir`
`-b`	`--baseURL`
`-s`	`--source`
`-e`	`--environment`

--config、--quiet 等没有简写；不要把 -c 当成 --config 使用（它是 --contentDir）。

简写和子命令会随 Hugo 版本演进。本文按本仓库要求的 Hugo Extended 版本线整理；在其他机器上以 hugo help、hugo <command> --help 和 hugo version 的实际输出为准。

Cheat Sheet on 纪伟的个人博客

VS Code 使用指南：高效编写与阅读 Markdown

写在前面

一、把文章目录作为工作区打开

二、预览 Markdown

三、用大纲审查文章结构

四、多光标与批量编辑

五、Markdown 编辑的内置能力

六、表格、代码块与图片

6.1 表格

6.2 代码块

6.3 Hugo Leaf Bundle 图片

七、专注写作与阅读

八、Snippet：固化文章骨架

九、扩展的选择原则

十、Hugo 文章的完整工作流

10.1 创建文章

10.2 编写时

10.3 本地预览

10.4 提交前

十一、最值得记住的快捷键

参考资料

命令行脚本实战（三）：Bash Shell 语法与 Linux 自动化

写在前面

一、Shebang 与执行方式

二、变量、环境变量与参数

三、引号与 Shell 展开

四、参数展开

五、条件与 case

六、循环、数组与读取文件

七、函数与返回状态

八、管道、重定向与状态码

九、set -euo pipefail 不是魔法

十、完整实战：构建并打包 Hugo 站点

十一、常见陷阱

十二、三种脚本怎么选

参考资料

命令行脚本实战（二）：PowerShell 语法与对象管道

写在前面

一、Cmdlet 与发现式学习

二、变量、集合与哈希表

三、字符串与展开

四、条件、循环与 switch

五、对象管道

六、函数与参数

七、文件、JSON 与 HTTP

八、错误处理与原生程序

九、完整实战：生成文件清单

十、快速选择

参考资料

命令行脚本实战（一）：Windows Batch（BAT）语法与自动化

写在前面

一、Batch、BAT 与 CMD

二、参数、变量与引号

2.1 命令行参数

2.2 环境变量

三、条件判断

四、循环与延迟展开

五、管道、重定向与转义

六、子程序与作用域

七、完整实战：封装构建命令

八、常见陷阱

九、什么时候使用 Batch

参考资料

Kubectl 命令速查手册

写在前面

一、基础操作

1.1 集群信息

1.2 命名空间

1.3 通用操作

二、Pod 管理

2.1 查看 Pod

2.2 Pod 生命周期

2.3 快速创建 Pod

2.4 容器交互

2.5 端口转发

三、工作负载管理

3.1 Deployment

3.2 StatefulSet

3.3 DaemonSet

九、`set -euo pipefail` 不是魔法