附录 D 深入阅读总表

本表由 workshop/links.yaml 生成，与各章“深入阅读”一致。

第 1 章 · VS Code

VS Code 官方文档：从安装到调试的完整文档，先看 Get Started。
快捷键速查表（Windows PDF）：官方一页纸，打印贴在旁边；macOS 版把 windows 换成 macos。
Tips and Tricks：官方整理的高效用法，多光标、Emmet、代码片段都在这里。
调试：launch.json 的每个字段和断点的各种玩法。
用户与工作区设置：设置的层级和全部可配置项。
Linux 安装（apt 源）：Debian/Ubuntu、Fedora 等发行版的官方源配置，先按它加源再 apt install。

第 2 章 · VS Code 通用扩展

Remote - SSH：连接服务器、配置 SSH 主机、远程端扩展的安装和排障。
扩展管理：安装、禁用、推荐列表、命令行管理扩展的官方说明。
配置文件（Profiles）：新建、切换、导出配置文件，按项目分开扩展组合。
远程开发概览：Remote - SSH、WSL、Dev Containers 的原理和入门。
工作区信任：受限模式下哪些功能和扩展会被禁用。
扩展市场：搜索、查看评分和更新记录；ID 在详情页的 Marketplace 信息里。

第 3 章 · VS Code 按语言的扩展

Python 入门教程：从装扩展、选解释器、建虚拟环境到运行和调试第一个 Python 文件。
TypeScript：内置 TypeScript 支持、tsconfig.json、切换工作区 TypeScript 版本。
C#：C# Dev Kit 和 C# 扩展各管什么、许可说明、项目和测试。
Go：Go 扩展的工具安装、保存时格式化、测试和调试。
调试配置：launch.json 的写法、常用属性和变量，各语言的调试配置都按它写。

第 4 章 · 终端与 Shell

Windows Terminal 文档：安装、设置界面、配置文件、窗格和快捷键的官方说明。
PowerShell 文档：PowerShell 7 的安装、配置文件、执行策略和全部 cmdlet 参考。
WSL 文档：安装 WSL、设置 Linux 用户、跨文件系统工作和 VS Code 配合。
Bash 参考手册：GNU 官方手册，重定向、变量、启动文件的准确规则都在这里。
ExplainShell：粘贴一条 bash 命令，逐段解释每个部分和参数的含义。

第 5 章 · 现代命令行小工具

ripgrep：安装、用法指南（GUIDE.md）和配置文件写法。
fd：各平台安装方法和全部选项的示例。
fzf：Shell 集成、快捷键和搜索语法（空格、^、$、! 的含义）。
jq 手册：过滤式的全部语法和内置函数，select、map、–arg 都在这里。
tldr pages：社区维护的命令示例库，也能在网页上直接查。
zoxide：各 Shell 的初始化写法和 z、zi 的用法。

第 6 章 · SSH 与远程

OpenSSH 手册：ssh、scp、sftp、ssh-keygen、sshd 等每个程序的官方手册页入口。
ssh_config 手册：~/.ssh/config 里每个配置项的准确含义和默认值。
Windows 上的 OpenSSH：在 Windows 上安装 OpenSSH 客户端和服务器、启动服务、放行防火墙。
GitHub：使用 SSH 连接：生成密钥、添加到 GitHub 账号、测试连接和排错，有中文。
tmux wiki：tmux 官方入门、快捷键和配置说明。

第 7 章 · Git 基础

Git 官方参考手册：每条命令的全部选项，查参数到这里。
Pro Git 第 2 版（中文）：免费的官方教材，前三章读完就够日常用。
Learn Git Branching：在浏览器里可视化练分支、合并、rebase。
gitignore 模板：各语言和编辑器的 .gitignore，复制就能用。
GitHub 的 Git 入门：从 GitHub 角度讲 Git 日常操作，有中文。

第 8 章 · Git 进阶与救急

git rebase 参考：交互式变基的全部指令、–autosquash、–update-refs 和冲突处理。
git reflog 参考：HEAD@{n} 的写法、查看和清理引用日志、条目保留多久。
git bisect 参考：二分查找的完整流程，bisect run 的退出码约定和 skip 的用法。
git worktree 参考：多工作区的增删、加锁、清理失效目录。
git filter-repo：安装方法和从历史中删除文件、替换密钥文本的示例。
GitHub：关于 Git 变基：从 GitHub 角度讲交互式变基的各个指令，有中文。

第 9 章 · GitHub

GitHub 文档（中文）：仓库、拉取请求、Actions、账号和认证的官方说明，有中文。
GitHub CLI 手册：gh 每条子命令的用法和参数，安装一节里有 Linux 的官方 apt 源。
拉取请求：建 PR、评审、合并方式和解决冲突，有中文。
关于受保护分支：保护分支每一项规则的含义，以及和规则集的关系。
GitLab 文档：合并请求、GitLab CI/CD 和 glab 命令行工具。
Gitee 帮助中心：Gitee 的 Pull Request、Issue、发行版和 Gitee Go 流水线。

第 10 章 · GitHub Actions 与 CI

GitHub Actions 文档：入门教程、各种语言的构建测试示例和运行器说明，有中文。
工作流语法：工作流文件里每个键的写法和取值，查 on、jobs、strategy 到这里。
安全使用指南：机密、GITHUB_TOKEN 权限、第三方 Action 和脚本注入的安全做法。
Actions 市场：按用途搜别人写好的 Action，用之前看它的 README 和维护情况。
官方工作流模板：各种语言和框架的现成工作流，Actions 页“新建工作流”里列出的就是这些。

第 11 章 · 格式化、lint 与提交钩子

EditorConfig：.editorconfig 每个属性的含义，以及哪些编辑器内置支持、哪些要装插件。
Prettier 文档：可调选项、忽略文件的写法，以及和 ESLint 一起用的说明。
ESLint 文档：平面配置 eslint.config.js 的写法、规则列表和从 .eslintrc 迁移的指南。
Ruff 文档：格式化器和 lint 的全部规则、pyproject.toml 里的配置项。
pre-commit：.pre-commit-config.yaml 的全部键、local 钩子的写法和常用钩子列表。
约定式提交（中文）：feat、fix 等前缀的规范和破坏性变更的写法。

第 12 章 · Docker

Docker 官方文档：从入门指南到 Engine、Desktop、Build 的完整文档，先看 Get started。
Dockerfile 参考：每条指令的写法和细节，FROM、COPY、RUN、CMD 的区别查这里。
Docker CLI 参考：每条 docker 子命令的全部参数和示例。
Docker Hub：找官方镜像，看每个镜像支持哪些标签和环境变量。
Linux 安装（Ubuntu）：添加 Docker 官方 apt 源再安装 Docker Engine 的完整步骤，装完接着看 Linux 安装后步骤。

第 13 章 · Docker Compose

Docker Compose 文档：入门教程、网络、环境变量、多文件合并等专题，先看 How Compose works。
Compose 文件参考：services、volumes、networks 下每个键的写法，depends_on、healthcheck 的全部选项查这里。
Compose 命令参考：docker compose 每个子命令的全部参数和示例。
用 profiles 按组启动服务：profiles 的写法、多组同时启用、COMPOSE_PROFILES 环境变量。
Awesome Compose 示例：Docker 官方维护的各种技术栈的 compose 示例，应用加数据库的写法可以照抄。

第 14 章 · 包管理器对照

npm 命令参考：npm install、ci、update、config 等每个命令的参数，.npmrc 的全部配置项也在这里。
uv 文档：项目、依赖、锁文件、Python 版本管理和 uv.toml 的写法，先看 Projects 一节。
pip 用户指南：requirements 文件、配置文件位置、换索引和缓存。
NuGet 文档：dotnet 的包引用、nuget.config、锁文件和包源的配置。
Go Modules 参考：go.mod、go.sum、最小版本选择、GOPROXY 和 go get 的完整说明。

第 15 章 · 环境变量与 .env

about_Environment_Variables：PowerShell 里读写环境变量的三种方式，Windows 上 Machine、User、Process 三个范围和持久化。
Node.js –env-file：.env 的格式、引号和注释的处理、多个文件的覆盖顺序，已有环境变量优先。
python-dotenv：load_dotenv 的 override 参数、dotenv run 命令行和 .env 文件语法。
开发中安全存储应用机密：dotnet user-secrets 的命令、secrets.json 的位置，以及在代码里读取。
十二要素应用：配置：为什么把随部署环境变化的配置放进环境变量，而不写进代码。

第 16 章 · Nginx

Nginx 文档：全部模块和指令的索引，查一条指令的语法、默认值和能写在哪一层。
初学者指南：启动停止重载、配置文件结构、静态站点和简单代理，第一次配置先看这篇。
ngx_http_proxy_module：proxy_pass 带不带路径的区别、proxy_set_header 的默认值、各种超时和缓冲。
Nginx 下载页：主线版、稳定版的源码包和 Windows zip，Windows 上本机试配置从这里下载。
Certbot 指引（Nginx）：选好服务器系统后给出安装 Certbot、申请证书、测试自动续期的逐条命令。
Mozilla SSL 配置生成器：选 Nginx 和版本，生成 ssl_protocols、ssl_ciphers 等 HTTPS 配置，手写 443 时照抄。

第 17 章 · Caddy

Caddy 文档：安装、命令行、Caddyfile 和全部指令的入口，查一条指令的语法和默认值。
Caddyfile 概念：全局选项块、站点块、地址写法、匹配器和占位符，看懂别人的 Caddyfile 先读这篇。
自动 HTTPS：什么情况下自动申请证书、本地 CA 和 caddy trust、证书存在哪、申请失败怎么排查。
reverse_proxy 指令：多个后端的负载均衡、健康检查、默认转发的请求头和超时。

第 18 章 · HTTP 调试

curl 手册：curl 全部选项的说明，查 –json、-w 能打印的变量、.curlrc 的查找顺序。
Everything curl：curl 作者写的完整教程，从发 GET 讲到认证、Cookie、代理和 TLS 证书。
HTTPie 文档：请求项写法（= 和 := 的区别）、表单和上传、会话、配置文件和 –ignore-stdin。
Bruno 文档：集合与请求文件格式、环境变量和 Secret 变量、Git 协作、命令行 bru run。
Cloudflare 快速隧道：cloudflared tunnel –url 的用法、只许指定邮箱访问的写法和快速隧道的限制。
HTTP 响应状态码（MDN）：每个状态码的含义和典型场景，遇到不认识的状态码来这里查。

第 19 章 · 浏览器开发者工具

Chrome 开发者工具文档：各面板的教程和参考，从 Elements、Console 到 Network、Sources 断点。
Chrome 开发者工具快捷键：全部快捷键按面板分组，Windows/Linux 与 Mac 两列，本章 19.3 据此核对。
Network 面板参考：过滤语法、请求详情各标签、Timing 各段的含义、限速和请求拦截。
Microsoft Edge 开发者工具文档：Edge 版的中文文档，含改界面语言、设备仿真和 Edge 特有的工具。
什么是浏览器开发者工具（MDN）：以 Firefox 为主介绍查看器、控制台和调试器，各浏览器怎么打开开发者工具。

第 20 章 · 数据库通用

PostgreSQL 教程：官方入门教程，从建库建表、联表查询、分组讲到事务、视图和外键。
SQLite 支持的 SQL：SQLite 每条语句的语法图，含 EXPLAIN QUERY PLAN、UPSERT 和 PRAGMA。
Use The Index, Luke：讲索引怎么工作、怎么读执行计划，例子覆盖 PostgreSQL、MySQL、Oracle、SQL Server。
DBeaver 文档：新建连接、驱动下载、SSH 隧道连库、数据导入导出。
Alembic 教程：从 alembic init 到 upgrade、downgrade，以及按模型自动生成迁移脚本。

第 21 章 · PostgreSQL

PostgreSQL 文档：官方手册，SQL 命令、数据类型、配置项、备份与复制都在这里，页面顶部可切换版本。
psql 参考：psql 的全部命令行参数和以反斜杠开头的元命令，含 \copy、\x、\timing。
pg_dump 参考：四种导出格式、只导某些表或模式的参数，以及跨版本导出的注意事项。
客户端认证 pg_hba.conf：pg_hba.conf 每一列的写法、匹配顺序和 trust、peer、scram-sha-256 等认证方式。
调优你的 PostgreSQL 服务器（PostgreSQL wiki）：shared_buffers、work_mem、max_connections 等关键配置项该怎么估算。
下载：不想用 Docker 时，Windows 安装包、macOS、各 Linux 发行版的官方安装方法。

第 22 章 · MySQL 与 MariaDB

MySQL 8.4 参考手册：官方手册，SQL 语句、数据类型、服务端配置项、账号与权限、复制都在这里。
mysql 命令行客户端：mysql 客户端的命令行参数、\G \s 等内置命令，以及怎么从文件执行 SQL。
mysqldump：导出一个库、几张表或全部库的写法，–single-transaction 与锁表的关系。
字符集、排序规则与 Unicode：服务端、库、表、列、连接各层字符集怎么定，utf8mb3 与 utf8mb4 的区别。
MariaDB 文档（原知识库）：MariaDB 的官方文档，含与 MySQL 的兼容性和差异说明。
下载：不想用 Docker 时，MySQL 社区版在 Windows、macOS、各 Linux 发行版的官方安装包。

第 23 章 · SQLite

SQLite 文档：官方文档目录，SQL 语法、数据类型、文件格式、C 接口和各项限制都从这里进。
sqlite3 命令行：全部点命令、各种输出模式、导入导出 CSV、.backup 和 .dump 的用法。
何时使用 SQLite（Appropriate Uses）：哪些场合 SQLite 够用，哪些场合该换成客户端/服务器式的数据库。
WAL 模式：WAL 的工作方式、检查点、-wal 和 -shm 文件，以及为什么不能用在网络文件系统上。
PRAGMA 语句：journal_mode、synchronous、foreign_keys、busy_timeout 等每个 PRAGMA 的取值和默认值。

第 24 章 · MongoDB

MongoDB 手册：官方手册，CRUD、索引、聚合、安全、复制与分片都在这里，含各平台安装社区版服务端的步骤。
mongosh 文档：mongosh 的连接写法、命令行参数、数据类型（Int32、Double、Decimal128）和脚本执行。
MongoDB Database Tools：mongodump、mongorestore、mongoimport、mongoexport 的全部参数和安装方法。
聚合操作：聚合管道的工作方式、各个阶段（$match、$group、$lookup 等）和与 SQL 的对照。
安全检查清单：上线前要做的安全设置：开启认证、最小权限、限制监听地址、加密连接。

第 25 章 · Redis

Redis 官方文档：入门、数据结构、运维都在这里。
命令参考：每条命令的参数、复杂度和示例，查命令到这里。
数据结构详解：五种核心结构加 Stream、Bitmap 等的用法和适用场景。
持久化：RDB 和 AOF 怎么选、怎么配。
下载与本机安装：不想用 Docker 时各平台的安装方法。

第 26 章 · 消息队列总览

RabbitMQ 教程：官方入门教程总览，从“Hello World”到工作队列、发布订阅、路由、主题，各种语言客户端都有一套。
消费者确认与发布者确认：手动确认、自动确认、prefetch、nack 与重投，以及生产者怎样确认消息已被服务端收下。
Kafka 介绍：官方的概念介绍：事件、主题、分区、副本、生产者与消费者，以及 Kafka 能做什么。
Redis Streams：XADD、XREADGROUP、XACK、XPENDING、XAUTOCLAIM 的用法和消费者组的工作方式。
Enterprise Integration Patterns：Messaging：消息系统的经典模式目录，点对点通道、发布订阅、死信通道、幂等接收者等都有图和说明。

第 27 章 · RabbitMQ

RabbitMQ 文档：官方文档首页，交换机与队列、持久化、确认、访问控制、内存与磁盘告警、配置文件都从这里进。
Python 入门教程：Hello World：官方教程第一篇的 pika 版本，从连接、声明队列到收发一条消息，后面几篇依次讲工作队列、发布订阅、路由和主题。
rabbitmqctl 参考：rabbitmqctl 全部命令和可显示的列，list_queues、list_bindings、add_user、set_permissions、set_policy 都在这里。
死信交换机：哪些情况下消息进死信、x-dead-letter-exchange 与策略两种配法、x-death 消息头的含义。
下载与安装：官方 Docker 镜像和 Windows、macOS、Debian/Ubuntu、RPM 各平台本机安装服务的步骤。

第 28 章 · Kafka

Kafka 4.0 文档：官方文档首页，设计、配置、运维、安全、KRaft 都从这里进。
快速开始：下载解压或用 Docker 起一个单节点，建主题、发、收消息的最短路径；本机不用 Docker 时照这里装。
apache/kafka Docker 镜像：官方镜像的标签、单节点启动示例，以及用 KAFKA_ 环境变量覆盖配置的规则。
broker 配置参考：server.properties 全部配置项的含义、类型和默认值，log.retention.hours、num.partitions、advertised.listeners、log.dirs 都在这里。

第 29 章 · Linux 服务器基本功

Ubuntu Server 文档：Ubuntu 官方服务器文档，用户与权限、软件包、OpenSSH、防火墙、自动更新、备份都有分步说明。
防火墙 ufw（Ubuntu Server 文档）：ufw 的启用、放行端口、按应用名放行、查看与删除规则，以及日志。
Ubuntu 手册页：sshd_config：Ubuntu 24.04 上 sshd_config 每个配置项的含义和默认值，PermitRootLogin、PasswordAuthentication、AllowUsers 都在这里。
Linux man-pages（man7.org）：Linux 命令和系统调用的手册页总目录，chmod、kill、信号（signal(7)）、crontab(5) 等都能查到。
crontab.guru：输入五段的 cron 表达式，立刻用英文说明它什么时候运行，并显示接下来几次的时间。
Ubuntu 初始服务器设置（DigitalOcean 教程）：新服务器建普通用户、授予 sudo、开 ufw、配置 SSH 密钥登录的分步教程，长期随 Ubuntu 版本更新。

第 30 章 · systemd 与进程管理

systemd.service 手册页：[Service] 段每个配置项的含义和默认值：Type、ExecStart 的路径规则、Restart 各取值在什么情况下拉起、RestartSec。
systemctl 手册页：start、enable、daemon-reload、edit、reset-failed、list-units 等全部子命令，以及 edit 生成的覆盖文件放在哪里。
journalctl 手册页：按单元、时间、级别过滤日志，-f 跟踪，–disk-usage 和 –vacuum-size 清理旧日志。
PM2 快速开始：安装 pm2、启动和管理 Node 程序、看日志、cluster 模式的基本用法。
PM2 开机启动脚本：pm2 startup 如何检测 systemd 并生成 pm2-用户名服务，pm2 save 保存程序列表，pm2 unstartup 撤销。

第 31 章 · 排障工具箱

Get-NetTCPConnection（Microsoft Learn）：按本地端口、状态筛选 TCP 连接，OwningProcess 列给出占用端口的进程号；参数和输出字段的完整说明。
Test-NetConnection（Microsoft Learn）：测试到某台主机的连通性和指定端口，TcpTestSucceeded 为 False 时再加 -InformationLevel Detailed 看细节。
Get-WinEvent（Microsoft Learn）：在命令行里读事件查看器的日志，FilterHashtable 按日志名、级别、时间筛选。
ss 手册页：-l、-t、-n、-p 各管什么，以及按端口、状态过滤的表达式写法（如 sport = :8080）。
可观测性（Ubuntu Server 文档）：Ubuntu 服务器上汇总日志和监控的官方做法：Logwatch 每日日志摘要、Nagios 和 Munin 监控、日志与指标告警栈。
502 Bad Gateway（MDN）：502 的含义：网关或代理从上游服务器收到了无效响应；同目录下有 503、504 等其余状态码的说明。