📚 日常工作知识库

记录排障过程、工程方法与可复用脚本，持续把零散经验沉淀成可检索、可复用、可发布的团队资产。本页由 npm run site:sync 自动生成，请勿手动维护文档列表。

使用方式

从左侧分类导航进入对应主题。
需要全局查找时优先使用站点搜索。
每篇文章尽量遵循“现象 / 背景 → 排查 → 根因 → 解决 → 预防”的结构，方便复盘与复用。

维护规则

公开文章是唯一事实来源，统一放在 site/<category>/*.md。
运行 npm run site:sync 会自动刷新 site/README.md、分类索引页和 .vitepress/config.mts。
npm run docs:build 与 npm run publish 会自动执行同步，作为最终兜底。

分类概览

分类	说明	文档数
网络 / CDN / 代理	网络访问、DNS、CDN、代理与本地网络环境排查。	1
CLI 工具	命令行工具安装、link、构建与报错排查。	2
前端开发	前端框架、构建工具、样式与性能优化经验。	0
DevOps	环境配置、CI/CD、容器化与部署实践。	0
开发工具技巧	Git、IDE、终端与知识库维护等效率实践。	1
Node.js 相关	Node.js、npm、pnpm 与运行时问题处理。	0
数据库	数据库、SQL、缓存与数据访问经验。	0
安全相关	权限、证书、安全风险与加固实践。	0

目录结构

text

site/
├── README.md                              # 公开知识库总览（自动生成）
├── index.md                               # 站点首页
├── network/                              # 网络 / CDN / 代理
│   ├── index.md                          # 分类索引（自动生成）
│   └── cdn-hosts-conflict-troubleshooting.md
├── cli/                                  # CLI 工具
│   ├── index.md                          # 分类索引（自动生成）
│   ├── npm-link-bin-missing.md
│   └── npm-link-missing-node-modules.md
├── frontend/                             # 前端开发
│   └── index.md                          # 分类索引（自动生成）
├── devops/                               # DevOps
│   └── index.md                          # 分类索引（自动生成）
├── tools/                                # 开发工具技巧
│   ├── index.md                          # 分类索引（自动生成）
│   └── knowledge-base-sync-workflow.md
├── nodejs/                               # Node.js 相关
│   └── index.md                          # 分类索引（自动生成）
├── database/                             # 数据库
│   └── index.md                          # 分类索引（自动生成）
└── security/                             # 安全相关
    └── index.md                          # 分类索引（自动生成）

文档索引

网络 / CDN / 代理

网络访问、DNS、CDN、代理与本地网络环境排查。

文档	日期	摘要
CDN 资源加载失败 — /etc/hosts 硬编码 IP 失效问题	2026-03-06	排查 /etc/hosts 中的历史硬编码记录导致 CDN 节点失效、TLS 握手中断与页面静态资源全部加载失败的问题。

CLI 工具

命令行工具安装、link、构建与报错排查。

文档	日期	摘要
npm link 关联失效或私有源安装 404 排查	2026-03-17	排查私有 npm 源缺包、构建产物未生成与 npm link 软链不完整导致 CLI 命令不可用的问题。
npm link 后 CLI 报错 — node_modules 缺失导致 MODULE_NOT_FOUND	2026-03-06	说明 npm link 依赖本地 node_modules 的运行机制，并给出 CLI 缺少依赖时报错的定位与修复步骤。