韵典综合平台

第一篇文章

2026-09-01T00:00:00Z

这是用 Markdown 写的博客内容。

关于本站对照国办发〔2017〕47号文开展设计规范调整的说明

2026-09-16T00:00:00Z

为进一步规范本站页面展现形式，提升信息服务质量，根据《政府网站发展指引》（国办发〔2017〕47号）及其附件《网页设计规范》有关要求，结合《政府网站与政务新媒体检查指标》（国办秘函〔2019〕19号）有关考核标准，本站于2026年9月对整体设计进行系统性调整。现将调整依据及主要内容说明如下。

一、调整依据

（一）《政府网站发展指引》（国办发〔2017〕47号）。该文件由国务院办公厅印发，是全国政府网站建设的基本规范，其中附件《网页设计规范》对网站的展现布局、地址链接、网页标签等提出了明确要求。

（二）《政府网站与政务新媒体检查指标》（国办秘函〔2019〕19号）。该文件明确了政府网站考核的单项否决指标和扣分指标，其中涉及页面加载时长、栏目更新情况、内容发布规范等具体要求。

（三）《政府网站集约化试点工作方案》（国办函〔2018〕71号）。该方案要求实现"统一标准体系、统一技术平台、统一安全防护、统一运维监管"，对站点技术架构和设计模式具有指导意义。

（四）山西省地方标准《政府网站集约化平台网页设计规范》（DB14/T 2544—2022）等行业性、地方性标准，作为本站在具体设计实施中的参考依据。

二、调整主要内容

（一）规范色调使用。规范要求"确定1种主色调，总色调不宜超过3种"。本站原设计围绕蓝色系展开了多个派生色，色值数量偏多。经调整，确立以深蓝（#015293）为主色调、白色为辅助色、红色（#e4393c）为强调色的三色体系，其余派生色统一收归为主色调的透明度变体，不再作为独立色值维护。

（二）统一字体字号。规范要求"同一类别的栏目和信息使用同一模板，统一字体、字号、行间距和布局"。经排查，原设计在 GovPanel 标题、markdown.css 的 h2、DocLayout 的 h2 等位置存在字号不一致问题。本次调整将上述位置的字号统一为 --gov-fs-lg，并清理了 SiteFooter、DocLayout 中重复定义的样式规则。

（三）优化加载性能。规范要求"页面加载时长不宜超过3秒"，检查指标将"网站打不开次数累计占比超过5%"列为单项否决。本站原内容层采用构建时全量内联方式，随内容数量增长将影响首屏体积。本次调整改为按需异步加载，配合空闲时预加载后续路由组件的方式，兼顾首屏速度与导航体验。

（四）完善内容展示。规范要求"网站内容要清晰显示发布时间，时间格式为YYYY—MM—DD HH:MM"。本站原列表项仅显示日期，本次调整在内容层增加 time 字段，列表与详情页均按规范格式显示完整时间。

（五）健全栏目管理。规范要求"栏目设置应科学合理，避免出现空白栏目"。本次调整新增"资源"栏目，统一收录开发工具、组件库等资源信息，并对文章列表、资源列表、搜索页的展示规则进行一致性梳理，明确各栏目数据来源，避免出现重复或空白栏目。

（六）扩展检索范围。在原站内搜索仅覆盖文章的基础上，新增资源检索，统一为 /search 页面，支持全部、文章、资源三类筛选，并可分享、可回退、可刷新，符合规范中"提供信息检索功能"的相关要求。

三、调整后效果

（一）色调统一。全站主色调、辅助色、强调色使用规范，页面整体观感协调一致。

（二）字号规范。同级标题字号一致，正文、辅助信息、数字等各级字号层级分明，符合用户阅读习惯。

（三）加载优化。首屏体积得到控制，配合路由预加载，主流网络环境下页面加载时长稳定控制在规范要求以内。

（四）内容完整。发布时间、信息来源、分类标签等要素展示完整，符合规范对内容展示的要求。

（五）结构清晰。头部标识区、中部内容区、底部功能区划分明确，底部功能区列明网站名称、备案编号、联系方式等信息。

四、后续工作

（一）持续跟踪国家关于政府网站建设的相关文件更新情况，及时对照调整本站设计。

（二）定期对站点进行自查，重点检查栏目更新、内容发布、页面性能等考核指标涉及的内容。

（三）结合用户反馈，进一步优化站内检索、无障碍访问、移动端适配等体验。

五、说明

本站为个人技术项目，非政府网站，本站视觉设计参照政府网站规范进行，旨在为用户提供规范、清晰、易读的信息服务。所有内容仅代表个人观点，与任何机构无关。

特此说明。

附：主要参考文件

简要说明

国办发〔2017〕47号：国务院办公厅2017年5月15日成文，6月8日发布，附件含《网页设计规范》。
国办秘函〔2019〕19号：国务院办公厅秘书局2019年4月1日成文，4月18日发布，含单项否决指标和扣分、加分指标。
国办函〔2018〕71号：国务院办公厅2018年10月27日成文，11月9日发布，要求“统一标准体系、统一技术平台”等。
DB14/T 2544—2022：山西省地方标准，2022年9月30日发布，12月30日实施，技术归口为山西省电子政务信息标准化技术委员会。

关于在 Markdown 中嵌入 Vue 组件的说明

2026-09-18T00:00:00Z

这篇文章已经过时，此描述的内容与现有架构不相同

本站的 .md 文件由 unplugin-vue-markdown 在构建时编译为 Vue 单文件组件。正文中的 Vue 组件标签会被当作模板的一部分解析，<script setup> 中的逻辑对正文完全可见。现将使用方法说明如下。

一、基本用法

在 frontmatter 之后、正文之前书写 <script setup>，导入所需组件与响应式 API 即可。

<script setup>
import { ref } from "vue";
import GovButton from "@/index/components/common/GovButton.vue";

const count = ref(0);
</script>

正文中可以像这样使用：
<GovButton variant="primary">按钮</GovButton>

组件标签与 Markdown 语法可以混用。以下为实际渲染效果：

当前计数：

增加

重置

文章内的 ref 是独立的响应式状态，作用域限于当前文章的组件实例，不会与其他文章或站点状态相互影响。

二、条件渲染与列表渲染

Vue 的 v-if、v-for 等指令在正文中同样有效。

切换显示

这段文字由 v-if 控制，当前可见。

这段文字由 v-else 控制，当前显示的是它。

下面的列表由 v-for 渲染，数据来自文章内的 <script setup>：

第项，共 3 项

三、嵌入组件

本站提供的政务组件均可在正文中直接使用。

以下按钮均为 GovButton 组件的不同 variant：

主要操作危险操作次要操作

下载官网源码文档

四、事件绑定

组件上的 @click 等事件可以直接绑定到文章内的函数。

点击弹出提示

实际写法如下：

<script setup>
function handleAlert() {
  alert("来自文章内的事件");
}
</script>

<GovButton variant="primary" @click="handleAlert">
  点击弹出提示
</GovButton>

五、注意事项

（一）组件需要显式导入。方案 B 下文章是独立的 Vue 组件，组件不会自动注册。必须在 <script setup> 中 import，不能依赖全局注册。

（二）自定义组件请显式闭合。markdown-it 在处理块级 HTML 时，自闭合的自定义组件标签（<MyIcon ... />）容易丢失自闭合标志，导致 Vue 编译器报 Element is missing end tag。建议所有自定义组件都写成 <MyIcon ...></MyIcon>，HTML void 元素（<br>、<img>）不受影响。

（三）旧版容器语法不再生效。本站早期的 ::: tip / ::: warning / ::: tabs 等自定义容器已在迁移中移除，改用原生 HTML 类表达，例如 <div class="md-alert md-alert--tip">…</div>。

（四）构建时编译。正文中的组件在构建阶段编译为 render function，而非运行时解析。若组件名拼写错误，会在构建时或开发时控制台提示，而不会静默忽略。

（五）样式作用域。文章内联写的 style 属性作用于当前元素，Markdown 渲染出的标签样式由 markdown.css 统一控制。若需要局部样式，建议在文章内使用内联 style，或封装为独立组件。

（六）不要写 <style> 块。本站暂不支持在 Markdown 中书写 <style>，会与 SFC 编译流程冲突。需要样式时优先使用已有 CSS 变量或内联样式。

六、小结

Markdown 与 Vue 的融合让静态内容具备了组件化的能力。文章不再只是纯文本，而是可以拥有响应式状态、可复用组件与事件交互的完整页面单元。这使得一些原本需要额外页面承载的功能，可以直接在文章内表达。

如需查看本站组件清单，可参阅《关于本站对照国办发〔2017〕47号文开展设计规范调整的说明》。

Node包管理器备忘录

2026-09-25T00:00:00Z

日常高频命令 + 国内换源方案。命令对照无差异时只写 npm。

一、换源

1.1 一键切换：nrm

npm install -g nrm

nrm ls                            # 列出所有源
nrm use taobao                    # 切到淘宝源
nrm use npm                       # 切回官方
nrm current                       # 查看当前
nrm test                          # 测速
nrm add company http://npm.company.com/    # 加私有源
nrm del company

1.2 手动切换

# npm
npm config set registry https://registry.npmmirror.com
npm config get registry
npm config delete registry        # 恢复默认

# yarn v1
yarn config set registry https://registry.npmmirror.com
yarn config get registry
yarn config delete registry

# pnpm
pnpm config set registry https://registry.npmmirror.com
pnpm config get registry

1.3 常用镜像源

源	URL
官方	`https://registry.npmjs.org`
淘宝 / npmmirror（推荐）	`https://registry.npmmirror.com`
腾讯云	`https://mirrors.cloud.tencent.com/npm/`
华为云	`https://mirrors.huaweicloud.com/repository/npm/`
cnpmjs	`https://registry.cnpmjs.org`

淘宝源域名 registry.npm.taobao.org 已废弃，新域名为 registry.npmmirror.com。

1.4 一次性使用（不改配置）

npm install --registry=https://registry.npmmirror.com
yarn add <pkg> --registry=https://registry.npmmirror.com
pnpm add <pkg> --registry=https://registry.npmmirror.com

1.5 项目级 .npmrc

只在当前项目生效，适合团队统一配置。放项目根目录：

# .npmrc
registry=https://registry.npmmirror.com
strict-ssl=true
save-exact=true
engine-strict=true

提交到 Git，让所有成员和 CI 用同一套源。

1.6 私有源 + 公共源混用（scoped registry）

公司包放私有源，公共包走镜像：

# .npmrc
registry=https://registry.npmmirror.com
@company:registry=https://npm.company.com/
//npm.company.com/:_authToken=${NPM_TOKEN}
//registry.npmmirror.com/:always-auth=false

@company 开头的包（如 @company/ui）走私有源，其余走淘宝源。

1.7 认证 Token 配置

# ~/.npmrc
//registry.npmjs.org/:_authToken=npm_xxxxxxxxxxxx
//npm.pkg.github.com/:_authToken=ghp_xxxxxxxxxxxx

或用环境变量（推荐 CI 使用）：

export NPM_TOKEN=xxxxx
# .npmrc 里写
//registry.npmjs.org/:_authToken=${NPM_TOKEN}

1.8 换源失败的排查

# 1. 确认当前源
npm config get registry

# 2. 直接 curl 试
curl -I https://registry.npmmirror.com/vue

# 3. 清除 npm 缓存
npm cache clean --force

# 4. 检查是否有多个 .npmrc 冲突
npm config list --show-origin

二、其他 binary 镜像（换源只改 npm 包，不改 binary）

很多包在 postinstall 阶段会下载非 npm 的二进制，换 registry 没用。这些要单独配：

2.1 Node 版本管理器镜像

nvm：

export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node
nvm install 20

写入 ~/.bashrc 或 ~/.zshrc 永久生效。

fnm：

export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node

2.2 Electron

# 项目 .npmrc
electron_mirror=https://npmmirror.com/mirrors/electron/
electron_builder_binaries_mirror=https://npmmirror.com/mirrors/electron-builder-binaries/

2.3 Puppeteer / Playwright

# .npmrc 或环境变量
puppeteer_download_host=https://npmmirror.com/mirrors
PLAYWRIGHT_DOWNLOAD_HOST=https://npmmirror.com/mirrors/playwright

2.4 node-sass / sass-embedded

# .npmrc
sass_binary_site=https://npmmirror.com/mirrors/node-sass

现在多用 sass（dart-sass 纯 JS 实现），无需 binary。

2.5 sharp / canvas

# .npmrc
sharp_binary_host=https://npmmirror.com/mirrors/sharp
sharp_libvips_binary_host=https://npmmirror.com/mirrors/sharp-libvips
canvas_binary_host_mirror=https://npmmirror.com/mirrors/node-canvas-prebuilt/

2.6 Cypress

export CYPRESS_DOWNLOAD_MIRROR=https://npmmirror.com/mirrors/cypress

2.7 全家桶模板

# ~/.npmrc 一份全搞定
registry=https://registry.npmmirror.com
electron_mirror=https://npmmirror.com/mirrors/electron/
electron_builder_binaries_mirror=https://npmmirror.com/mirrors/electron-builder-binaries/
puppeteer_download_host=https://npmmirror.com/mirrors
PLAYWRIGHT_DOWNLOAD_HOST=https://npmmirror.com/mirrors/playwright
sass_binary_site=https://npmmirror.com/mirrors/node-sass
sharp_binary_host=https://npmmirror.com/mirrors/sharp
sharp_libvips_binary_host=https://npmmirror.com/mirrors/sharp-libvips
canvas_binary_host_mirror=https://npmmirror.com/mirrors/node-canvas-prebuilt/
CYPRESS_DOWNLOAD_MIRROR=https://npmmirror.com/mirrors/cypress

三、命令对照速查

操作	npm	yarn (v1)	pnpm
安装全部	`npm install`	`yarn`	`pnpm install`
安装生产依赖	`npm i <pkg>`	`yarn add <pkg>`	`pnpm add <pkg>`
安装开发依赖	`npm i -D <pkg>`	`yarn add -D <pkg>`	`pnpm add -D <pkg>`
安装全局	`npm i -g <pkg>`	`yarn global add <pkg>`	`pnpm add -g <pkg>`
安装指定版本	`npm i <pkg>@1.2.3`	同	同
卸载	`npm uninstall <pkg>`	`yarn remove <pkg>`	`pnpm remove <pkg>`
卸载全局	`npm uninstall -g <pkg>`	`yarn global remove <pkg>`	`pnpm remove -g <pkg>`
更新全部	`npm update`	`yarn upgrade`	`pnpm update`
运行脚本	`npm run <s>`	`yarn <s>`	`pnpm <s>`
执行本地二进制	`npx <bin>`	`yarn <bin>`	`pnpm exec <bin>`
执行远程包	`npx <pkg>`	—	`pnpm dlx <pkg>`
查看顶层依赖	`npm ls --depth=0`	`yarn list --depth=0`	`pnpm list --depth=0`
查过时依赖	`npm outdated`	`yarn outdated`	`pnpm outdated`
清缓存	`npm cache clean --force`	`yarn cache clean`	`pnpm store prune`
查看为什么装了某包	`npm why <pkg>`	`yarn why <pkg>`	`pnpm why <pkg>`

四、锁文件

包管理器	锁文件	提交 Git
npm	`package-lock.json`	✅
yarn v1	`yarn.lock`	✅
pnpm	`pnpm-lock.yaml`	✅

同一仓库只保留一种锁文件。混用会导致依赖树不一致。

清理重装

# npm
rm -rf node_modules package-lock.json && npm install

# yarn
rm -rf node_modules yarn.lock && yarn install

# pnpm
rm -rf node_modules pnpm-lock.yaml && pnpm install

CI 严格安装

npm ci                            # 严格按 lock 装，不更新
pnpm install --frozen-lockfile
yarn install --frozen-lockfile

npm ci 要求 package-lock.json 与 package.json 完全一致，否则直接报错退出。

五、依赖版本语义

写法	允许升级范围
`1.2.3`	精确，不升级
`~1.2.3`	`>=1.2.3 <1.3.0`
`^1.2.3`	`>=1.2.3 <2.0.0`
`^0.2.3`	`>=0.2.3 <0.3.0`（0.x 例外，锁次版本）
`*` / `latest`	不限（不推荐）

六、脚本（scripts）

钩子

钩子	触发时机
`preinstall`	install 之前
`postinstall`	install 之后
`prepare`	install 和 publish 之前都触发（husky 常用）
`prepublishOnly`	仅 `npm publish` 之前
`pre<script>`	`npm run <script>` 之前
`post<script>`	执行之后

传参与环境变量

npm run build -- --mode production
yarn build --mode production
pnpm build --mode production

# 跨平台环境变量
npm i -D cross-env
"build": "cross-env NODE_ENV=production vite build"

七、依赖管理

overrides / resolutions（强制覆盖版本）

npm (>= 8.3)：

{
  "overrides": {
    "lodash": "4.17.21",
    "some-pkg": { "lodash": "4.17.21" }
  }
}

yarn v1：

{
  "resolutions": {
    "lodash": "4.17.21",
    "**/lodash": "4.17.21"
  }
}

pnpm：

{
  "pnpm": {
    "overrides": {
      "lodash": "4.17.21"
    }
  }
}

依赖分析

npm ls <pkg>                      # 谁依赖了它
npm why <pkg>                     # 同上（npm 8+）
pnpm why <pkg>
yarn why <pkg>

八、npm 专属

npm view <pkg>                    # 包信息
npm view <pkg> versions           # 所有版本
npm view <pkg> dist-tags          # 标签
npm info <pkg> repository.url     # 仓库地址

npm login
npm publish                       # 发布
npm publish --access public       # scoped 包首次发布
npm publish --tag beta            # 打标签
npm unpublish <pkg>@1.0.0         # 撤销（24h 内）

九、yarn v1 专属

workspaces

{
  "private": true,
  "workspaces": ["packages/*"]
}

yarn workspace <pkg> add <dep>
yarn workspaces info

常用

yarn licenses list                # 许可证
yarn audit                        # 安全审计
yarn autoclean --init

yarn v1 已停止新功能开发，长期建议迁移到 pnpm 或 yarn berry (v2+)。

十、pnpm 专属

核心优势

硬链接 + 内容寻址存储：磁盘只存一份包实体，多项目共享。
非扁平化 node_modules：只有直接依赖可见，杜绝幽灵依赖。
严格 peerDependencies：不隐式提升未声明依赖。

常用

pnpm store path                   # store 位置
pnpm store prune                  # 清缓存
pnpm dedupe                       # 去重
pnpm patch <pkg>                  # 打补丁
pnpm patch-commit <path>

pnpm add -O <pkg>                 # optionalDependencies
pnpm add -P <pkg>                 # peerDependencies

工作区

# pnpm-workspace.yaml
packages:
  - "packages/*"
  - "apps/*"

pnpm -r build                     # 递归所有包
pnpm --filter web build           # 只跑 web
pnpm --filter "web..." build      # web 及其依赖
pnpm --filter "...web" build      # web 及其被依赖者

.npmrc 常用

shamefully-hoist=true             # 兼容老包（临时用）
strict-peer-dependencies=false
auto-install-peers=true
node-linker=hoisted               # 扁平常见兼容方案

十一、常见问题

1. `ERR_OSSL_EVP_UNSUPPORTED`（Node 17+）

老项目 + 新 Node，OpenSSL 3 引起。

export NODE_OPTIONS=--openssl-legacy-provider
# 或降级 Node 16

2. `EACCES` 权限错误

别用 sudo，改 npm 全局目录：

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

3. `peer dep` 冲突（npm 7+）

npm install --legacy-peer-deps    # 按 npm 6 行为忽略 peer 冲突
npm install --force               # 强制（危险）

4. 安装慢

先换源（见第一节）。如果还慢，看是不是在下载 binary：

npm install --verbose 2>&1 | grep -i "http"

看到下载 electron / puppeteer 之类的，就要配对应的 binary 镜像。

5. 幽灵依赖

代码用了没在 package.json 里声明的包（因为被提升到顶层才碰巧能用）。

根治：用 pnpm。缓解：npm ls --depth=0 核对，把用到的都显式声明。

6. CI 报 lock 不一致

用 npm ci / pnpm install --frozen-lockfile 时，package.json 与 lock 必须同步。本地改完 package.json 一定要重跑一次 install 让 lock 更新，再提交。

7. 强制项目使用某个包管理器

{
  "scripts": {
    "preinstall": "npx only-allow pnpm"
  }
}

8. `npm audit fix --force` 引入 breaking change

--force 会跨越主版本升级。先看不 force 能修多少：

npm audit
npm audit fix
npm audit --production            # 只看生产依赖

十二、安全审计

npm audit
yarn audit
pnpm audit

参考

npm 文档：https://docs.npmjs.com/
yarn v1：https://classic.yarnpkg.com/
pnpm：https://pnpm.io/zh/
npmmirror：https://npmmirror.com/

Linux 备忘录

2026-09-25T00:00:00Z

国内环境下的高频命令。换源和镜像放在最前面。

一、换源

1.1 apt（Debian / Ubuntu）

先备份，再替换：

sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak
sudo sed -i 's|http://archive.ubuntu.com|https://mirrors.tuna.tsinghua.edu.cn|g' /etc/apt/sources.list
sudo sed -i 's|http://security.ubuntu.com|https://mirrors.tuna.tsinghua.edu.cn|g' /etc/apt/sources.list
sudo apt update

Ubuntu 24.04+ 使用新格式 /etc/apt/sources.list.d/ubuntu.sources：

sudo sed -i 's|http://archive.ubuntu.com|https://mirrors.tuna.tsinghua.edu.cn|g' \
  /etc/apt/sources.list.d/ubuntu.sources

Debian 12+ 使用 /etc/apt/sources.list.d/debian.sources，同理。

1.2 常用 apt 镜像源

源	URL
清华	`https://mirrors.tuna.tsinghua.edu.cn`
阿里云	`https://mirrors.aliyun.com`
中科大	`https://mirrors.ustc.edu.cn`
华为云	`https://mirrors.huaweicloud.com`
网易	`https://mirrors.163.com`

1.3 yum / dnf（RHEL / CentOS / Fedora）

# 备份
sudo cp -r /etc/yum.repos.d /etc/yum.repos.d.bak

# CentOS 7 换阿里云
sudo sed -i 's|mirrorlist=|#mirrorlist=|g' /etc/yum.repos.d/CentOS-*.repo
sudo sed -i 's|#baseurl=http://mirror.centos.org|baseurl=https://mirrors.aliyun.com|g' \
  /etc/yum.repos.d/CentOS-*.repo

sudo yum clean all
sudo yum makecache

CentOS 8 / Stream 需要先换 vault（官方源已下线）：

sudo sed -i 's|mirror.centos.org|mirrors.aliyun.com|g' /etc/yum.repos.d/*.repo
sudo sed -i 's|^#baseurl|baseurl|g' /etc/yum.repos.d/*.repo
sudo sed -i 's|^mirrorlist|#mirrorlist|g' /etc/yum.repos.d/*.repo
sudo dnf clean all && sudo dnf makecache

Fedora：

sudo sed -i 's|^metalink=|#metalink=|g' /etc/yum.repos.d/fedora*.repo
sudo sed -i 's|^#baseurl=http://download.example/pub/fedora/linux|baseurl=https://mirrors.tuna.tsinghua.edu.cn/fedora|g' \
  /etc/yum.repos.d/fedora*.repo

1.4 pacman（Arch）

编辑 /etc/pacman.d/mirrorlist，把国内源放前面：

Server = https://mirrors.tuna.tsinghua.edu.cn/archlinux/$repo/os/$arch
Server = https://mirrors.ustc.edu.cn/archlinux/$repo/os/$arch

或者一键：

sudo pacman -S reflector
sudo reflector --country China --latest 5 --sort rate --save /etc/pacman.d/mirrorlist
sudo pacman -Syyu

1.5 pip 换源

# 永久
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
pip config set global.trusted-host pypi.tuna.tsinghua.edu.cn

# 或写入 ~/.pip/pip.conf (Linux) / %APPDATA%\pip\pip.ini (Windows)
# [global]
# index-url = https://pypi.tuna.tsinghua.edu.cn/simple
# trusted-host = pypi.tuna.tsinghua.edu.cn

# 一次性
pip install <pkg> -i https://pypi.tuna.tsinghua.edu.cn/simple

常用 pip 镜像：

源	URL
清华	`https://pypi.tuna.tsinghua.edu.cn/simple`
阿里云	`https://mirrors.aliyun.com/pypi/simple/`
中科大	`https://pypi.mirrors.ustc.edu.cn/simple/`
豆瓣	`https://pypi.douban.com/simple/`
华为云	`https://mirrors.huaweicloud.com/repository/pypi/simple/`

1.6 Docker 镜像加速

编辑 /etc/docker/daemon.json：

{
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://dockerproxy.com",
    "https://mirror.baidubce.com",
    "https://ccr.ccs.tencentyun.com"
  ]
}

sudo systemctl daemon-reload
sudo systemctl restart docker
docker info | grep -A 5 "Registry Mirrors"

2024 年后很多公共镜像源已停服，以上仅供参考。企业环境建议自建 Harbor 或使用阿里云/腾讯云容器镜像服务。

1.7 Go module 代理

go env -w GOPROXY=https://goproxy.cn,direct
go env -w GOSUMDB=sum.golang.google.cn

1.8 Maven 换源

编辑 ~/.m2/settings.xml：

<mirrors>
  <mirror>
    <id>aliyun</id>
    <mirrorOf>central</mirrorOf>
    <url>https://maven.aliyun.com/repository/public</url>
  </mirror>
</mirrors>

1.9 换源后必做

# apt
sudo apt update

# yum / dnf
sudo yum clean all && sudo yum makecache
sudo dnf clean all && sudo dnf makecache

# pacman
sudo pacman -Syyu

二、文件与目录

pwd                               # 当前目录
ls -alh                           # 详细列表
cd -                              # 上一个目录
mkdir -p a/b/c                    # 递归创建
rm -rf <dir>                      # 递归删除（危险）
cp -r <src> <dst>                 # 递归复制
mv <src> <dst>                    # 移动 / 重命名
ln -s <target> <link>             # 软链接
touch <file>
stat <file>
file <file>

查找

find . -name "*.log"                          # 按名
find . -type f -size +100M                    # >100M
find . -mtime -7                              # 7 天内
find . -name "*.tmp" -delete                  # 找到删除
find . -type f -exec chmod 644 {} \;          # 批量执行

which <cmd>                       # 命令路径
whereis <cmd>
locate <file>                     # 快速（需 updatedb）

三、文本处理

cat / less / head -n 20 / tail -n 20
tail -f <file>                    # 实时跟踪日志
tail -F <file>                    # rotate 后仍能跟踪

grep "p" <file>                   # 基本
grep -r -n -i "p" .               # 递归+行号+忽略大小写
grep -v "p" <file>                # 反选
grep -E "a|b" <file>              # 扩展正则
rg "p"                            # ripgrep（快，推荐）

sed 's/old/new/g' <file>          # 替换到 stdout
sed -i 's/old/new/g' <file>       # 原地替换
sed -i.bak 's/old/new/g' <file>   # 带备份
sed -n '10,20p' <file>            # 打印范围

awk '{print $1}' <file>           # 第一列
awk -F: '{print $1}' /etc/passwd
awk '$3 > 100 {print $1}' <file>

cut -d: -f1 /etc/passwd
sort <file>
sort -u <file>                    # 去重
uniq -c                           # 统计相邻（先 sort）
wc -l <file>
tr 'a-z' 'A-Z'

管道组合

awk '{print $1}' access.log | sort | uniq -c | sort -rn | head -10
du -sh */ | sort -rh | head -10

四、权限

chmod 755 <file>
chmod +x <file>
chmod -R 644 <dir>
chown user:group <file>
chown -R user <dir>
chgrp group <file>
umask

数字权限：

数字	权限
4	r--
5	r-x
6	rw-
7	rwx

例：755 = rwxr-xr-x，644 = rw-r--r--。

特殊权限：

chmod u+s <file>                  # SUID
chmod g+s <dir>                   # SGID
chmod +t <dir>                    # Sticky（如 /tmp）

五、进程管理

ps aux
ps aux | grep nginx
pgrep -f "pattern"
pidof <name>

top                               # P 按 CPU，M 按内存
htop                              # 更友好

kill <pid>                        # SIGTERM
kill -9 <pid>                     # 强制
pkill -f "pattern"
killall <name>

nice -n 10 <cmd>
renice -n 5 -p <pid>

Ctrl+Z                            # 挂起
bg / fg / jobs

信号：

信号	编号	说明
SIGHUP	1	挂起 / 重载
SIGINT	2	Ctrl+C
SIGKILL	9	强杀，不可捕获
SIGTERM	15	优雅退出（默认）

六、网络

ip addr                           # 查看 IP
ip route
ss -tunlp                         # 监听端口（推荐）
netstat -tunlp                    # 老命令
lsof -i :8080                     # 谁占端口

ping <host>
ping -c 4 <host>
traceroute <host>
mtr <host>                        # 持续 traceroute

curl -I <url>                     # 只看头
curl -v <url>                     # 详细
curl -o file.zip <url>            # 下载
curl -X POST -d '{}' -H "Content-Type: application/json" <url>

wget <url>
wget -c <url>                     # 断点续传
wget -r -np <url>                 # 递归

dig <domain>
dig +short <domain>
nslookup <domain>
host <domain>

防火墙

# ufw（Ubuntu）
ufw status
ufw allow 22
ufw allow 80/tcp
ufw delete allow 80
ufw enable

# firewalld（CentOS）
firewall-cmd --list-all
firewall-cmd --add-port=8080/tcp --permanent
firewall-cmd --reload

# iptables
iptables -L -n -v
iptables -A INPUT -p tcp --dport 8080 -j ACCEPT

七、磁盘与内存

df -h                             # 磁盘
df -i                             # inode
du -sh <dir>
du -sh * | sort -rh | head -10

free -h                           # 内存
vmstat 1
iostat -x 1                       # 需 sysstat

lsblk
fdisk -l
mount /dev/sdb1 /mnt
umount /mnt

找大文件：

find / -type f -size +1G 2>/dev/null
du -ah / | sort -rh | head -20

八、压缩与归档

tar -czvf a.tar.gz <dir>          # 打包
tar -xzvf a.tar.gz                # 解包
tar -tzvf a.tar.gz                # 查看内容
tar -xzvf a.tar.gz -C /tmp

zip -r a.zip <dir>
unzip a.zip
unzip -l a.zip
unzip a.zip -d /tmp

gzip <file>
gunzip <file>.gz

zstd <file>                       # 快速压缩
xz -9 <file>                      # 高压缩

九、用户与权限

whoami
id
who
w
last

useradd -m -s /bin/bash <user>
passwd <user>
usermod -aG sudo <user>
userdel -r <user>

groupadd <group>
groups <user>

su - <user>
sudo <cmd>
sudo -i                           # 进 root shell
sudo -u <user> <cmd>

sudoers：

visudo

alice ALL=(ALL:ALL) ALL
%sudo ALL=(ALL:ALL) ALL
alice ALL=(ALL) NOPASSWD: ALL     # 免密

十、systemd

systemctl start/stop/restart/reload/status <svc>
systemctl enable/disable <svc>
systemctl is-active <svc>
systemctl list-units --type=service --state=running
systemctl daemon-reload

journalctl -u <svc>
journalctl -u <svc> -f
journalctl -u <svc> --since "1 hour ago"
journalctl -xe                    # 最近错误
journalctl -b                     # 本次启动
journalctl --disk-usage
journalctl --vacuum-size=500M     # 清理

unit 文件示例 /etc/systemd/system/myapp.service：

[Unit]
Description=My App
After=network.target

[Service]
Type=simple
User=appuser
WorkingDirectory=/opt/myapp
ExecStart=/usr/bin/node /opt/myapp/index.js
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable --now myapp

十一、SSH

ssh user@host
ssh -p 2222 user@host
ssh -i ~/.ssh/id_rsa user@host

ssh-keygen -t ed25519 -C "comment"
ssh-copy-id user@host

ssh -L 8080:localhost:80 user@host   # 本地转发
ssh -R 8080:localhost:80 user@host   # 远程转发
ssh -D 1080 user@host                # SOCKS 代理

~/.ssh/config：

Host myserver
    HostName 1.2.3.4
    User alice
    Port 2222
    IdentityFile ~/.ssh/id_ed25519

之后 ssh myserver 即可。

传输

scp <file> user@host:/path/
scp user@host:/path/<file> .
scp -r <dir> user@host:/path/

rsync -avz --progress <src> user@host:<dst>   # 增量同步
rsync -avz --delete <src> user@host:<dst>

十二、软件包管理

apt（Debian / Ubuntu）

sudo apt update                   # 更新索引
sudo apt upgrade                  # 升级
sudo apt full-upgrade             # 含依赖变化
sudo apt install <pkg>
sudo apt remove <pkg>             # 保留配置
sudo apt purge <pkg>              # 含配置
sudo apt autoremove               # 清理无用依赖
sudo apt search <kw>
sudo apt show <pkg>
apt list --installed

sudo dpkg -i <pkg>.deb
dpkg -l | grep <pkg>

yum / dnf（RHEL / CentOS）

sudo yum install <pkg>
sudo yum remove <pkg>
sudo yum update
sudo yum search <kw>
sudo yum info <pkg>
yum list installed
yum clean all && yum makecache

sudo dnf install <pkg>            # 新一代
dnf upgrade
dnf clean all

sudo rpm -ivh <pkg>.rpm
rpm -qa | grep <pkg>
sudo rpm -e <pkg>

pacman（Arch）

sudo pacman -Syu                  # 同步并升级
sudo pacman -S <pkg>
sudo pacman -Rns <pkg>            # 卸载含依赖配置
pacman -Ss <kw>
pacman -Qs <pkg>

十三、日志

journalctl -xe
journalctl --since today
journalctl -p err                 # 只错误

tail -f /var/log/syslog           # Debian/Ubuntu
tail -f /var/log/messages         # RHEL/CentOS
tail -f /var/log/auth.log         # 认证
tail -f /var/log/nginx/access.log
tail -f /var/log/nginx/error.log

dmesg
dmesg -T                          # 人类可读时间
dmesg | tail -20

十四、环境变量

env
echo $PATH
export FOO=bar
unset FOO

# 永久
~/.bashrc                         # bash 交互式
~/.bash_profile                   # bash 登录
~/.profile                        # 通用
/etc/profile                      # 全局

source ~/.bashrc

export PATH="$HOME/.local/bin:$PATH"      # 前置
export PATH="$PATH:/opt/tools/bin"        # 后置

十五、性能排查

uptime                            # 负载
top                               # 实时
free -h                           # 内存
df -h / df -i                     # 磁盘 / inode
iostat -x 1                       # IO
sar -u 1 5                        # CPU 历史

通用排查顺序：

uptime + top：负载高不高、哪个进程占用。
free -h：内存是否耗尽、是否 swap。
df -h + df -i：空间 / inode 是否满。
iostat -x 1：IO 是否瓶颈。
ss -s：连接数是否异常。

定位细节

lsof -p <pid>                     # 进程打开的文件
lsof -i :8080                     # 端口占用
lsof /var/log/syslog

top -H -p <pid>                   # 线程
ps -T -p <pid>

tcpdump -i eth0 -n
tcpdump -i eth0 port 80
tcpdump -i eth0 host 1.2.3.4
tcpdump -i eth0 -w cap.pcap       # 存盘（Wireshark 打开）

十六、定时任务

crontab -e                        # 编辑
crontab -l                        # 列出
crontab -r                        # 删除

格式：

* * * * * <command>
│ │ │ │ │
│ │ │ │ └─ 星期（0-7，0/7 都是周日）
│ │ │ └─── 月（1-12）
│ │ └───── 日（1-31）
│ └─────── 时（0-23）
└───────── 分（0-59）

例：

0 3 * * * /opt/backup.sh              # 每天 3:00
*/5 * * * * /usr/bin/check.sh         # 每 5 分钟
0 9-18 * * 1-5 /opt/work.sh           # 工作日 9-18 整点

注意事项：

PATH 与登录 shell 不同，用绝对路径。
输出默认发邮件，重定向：>> /var/log/job.log 2>&1。
秒级任务用 systemd timer。

十七、实用技巧

history
history | grep <kw>
Ctrl+R                            # 反向搜索历史
!!                                # 上一条
!$                                # 上一条最后参数
!123                              # 历史编号 123

pushd /path / popd / dirs -v

nohup <cmd> > out.log 2>&1 &
disown

openssl rand -base64 16           # 随机密码
uuidgen
md5sum <file>
sha256sum <file>
xxd <file>
time <cmd>

python3 -m http.server 8000       # 快速 HTTP 服务

命令组合

cmd1 && cmd2                      # 成功才继续
cmd1 || cmd2                      # 失败才继续
cmd1 ; cmd2                       # 顺序
cmd1 &                            # 后台
(cmd1; cmd2)                      # 子 shell

变量

name="world"
echo "$name"
echo "${name}"
echo "$(date)"
echo '$name'                      # 不替换

: ${VAR:=default}                 # 默认值

str="hello.txt"


echo ${str%.txt}                  # hello
echo ${str#hello.}                # txt
echo ${str/txt/md}                # hello.md
echo ${#str}                      # 9

十八、快捷键

快捷键	作用
`Ctrl+C`	中断
`Ctrl+D`	退出 shell
`Ctrl+L`	清屏
`Ctrl+A` / `Ctrl+E`	行首 / 行尾
`Ctrl+U` / `Ctrl+K`	删光标前 / 后
`Ctrl+W`	删前一个单词
`Ctrl+R`	搜索历史
`Ctrl+Z`	挂起
`Tab` / `Tab Tab`	补全 / 列候选

参考

清华镜像站：https://mirrors.tuna.tsinghua.edu.cn/
中科大镜像站：https://mirrors.ustc.edu.cn/
阿里云镜像站：https://developer.aliyun.com/mirror/
npmmirror：https://npmmirror.com/
man 手册：man <command>
tldr：tldr <command>（需安装）

Git 备忘录

2026-09-25T00:00:00Z

日常高频命令速查。按"场景"而非"命令字母"组织，便于出问题时直接翻。

一、配置

# 用户信息（全局）
git config --global user.name "Your Name"
git config --global user.email "you@example.com"

# 换行符（Windows 推荐）
git config --global core.autocrlf true

# 中文文件名不乱码
git config --global core.quotepath false

# 默认分支名
git config --global init.defaultBranch main

# 常用别名
git config --global alias.st status
git config --global alias.co checkout
git config --global alias.br branch
git config --global alias.lg "log --oneline --graph --decorate --all"

# 查看所有配置
git config --list --show-origin

二、基础工作流

git status                    # 查看工作区状态
git add <file>                # 暂存指定文件
git add .                     # 暂存所有改动（不含删除）
git add -A                    # 暂存所有改动（含删除）
git commit -m "message"       # 提交
git commit -am "message"      # 跳过 add，直接提交已跟踪文件
git push                      # 推送
git pull                      # 拉取并合并

查看差异

git diff                      # 工作区 vs 暂存区
git diff --staged             # 暂存区 vs 最新提交
git diff HEAD                 # 工作区 + 暂存区 vs 最新提交
git diff <branch1>..<branch2> # 两分支差异

三、分支

git branch                    # 查看本地分支
git branch -a                 # 查看所有分支（含远程）
git branch -vv                # 查看分支及跟踪关系
git branch <name>             # 创建分支
git switch <name>             # 切换分支（新版推荐）
git switch -c <name>          # 创建并切换
git checkout -b <name>        # 同上（旧版写法）
git branch -d <name>          # 删除已合并分支
git branch -D <name>          # 强制删除
git branch -m <old> <new>     # 重命名分支

合并与变基

git merge <branch>            # 合并到当前分支（保留历史）
git merge --no-ff <branch>    # 强制生成合并提交
git rebase <branch>           # 变基（线性历史）
git rebase -i HEAD~3          # 交互式变基，重写最近 3 条提交

原则：已推送到共享远程的分支不要 rebase；只在本地分支上用。

四、撤销与回退

这是最容易踩坑的地方，先分清三种"撤销"：

命令	作用范围	是否修改历史	使用场景
`git restore`	工作区 / 暂存区	否	丢弃未提交的修改
`git reset`	暂存区 / 提交历史	是	撤销提交（未推送）
`git revert`	提交历史	否（新增反向提交）	撤销已推送的提交

丢弃工作区修改

git restore <file>            # 丢弃单个文件的未暂存修改
git restore .                 # 丢弃所有未暂存修改（危险）
git checkout -- <file>        # 旧版写法

取消暂存

git restore --staged <file>   # 从暂存区移回工作区
git reset HEAD <file>         # 旧版写法

撤销提交

# 保留改动在工作区
git reset --soft HEAD~1

# 保留改动在暂存区
git reset --mixed HEAD~1      # 默认

# 彻底丢弃改动（危险）
git reset --hard HEAD~1

# 撤销已推送的提交（安全）
git revert <commit-hash>

找回丢失的提交

git reflog                    # 查看 HEAD 移动历史
git reset --hard <hash>       # 回到某个历史位置

reset --hard 后如果后悔，reflog 通常能救回来，除非已经 GC。

五、贮藏（stash）

git stash                     # 贮藏当前改动
git stash -u                  # 含未跟踪文件
git stash list                # 查看贮藏列表
git stash pop                 # 弹出最近贮藏并删除
git stash apply stash@{0}     # 应用指定贮藏（保留）
git stash drop stash@{0}      # 删除指定贮藏
git stash clear               # 清空所有贮藏

常见场景：改了一半，突然要切分支修 bug。

六、远程

git remote -v                 # 查看远程仓库
git remote add origin <url>   # 添加远程
git remote set-url origin <url> # 修改远程地址
git remote remove origin      # 删除远程

git fetch                     # 拉取远程信息，不合并
git pull                      # fetch + merge
git pull --rebase             # fetch + rebase
git push                      # 推送
git push -u origin <branch>   # 首次推送并建立跟踪
git push --force-with-lease   # 安全强推（推荐）
git push --force              # 强推（危险）

强推原则：永远用 --force-with-lease，它会检查远程是否有人推过新提交，避免误覆盖别人的工作。

七、标签

git tag                       # 查看标签
git tag v1.0.0                # 轻量标签
git tag -a v1.0.0 -m "msg"    # 附注标签（推荐）
git push origin v1.0.0        # 推送单个标签
git push --tags               # 推送所有标签
git tag -d v1.0.0             # 删除本地标签
git push origin :refs/tags/v1.0.0  # 删除远程标签

八、查看历史

git log                       # 完整日志
git log --oneline             # 单行
git log --oneline --graph     # 图形化
git log -p <file>             # 查看某文件历史
git log --author="name"       # 按作者过滤
git log --since="2 weeks ago" # 按时间过滤
git log -S "keyword"          # 按内容变化搜索（pickaxe）
git blame <file>              # 逐行查看最后修改者
git show <commit>             # 查看某次提交详情

九、常见问题

1. 提交信息写错了（未推送）

git commit --amend -m "new message"

如果只是想补充文件：

git add forgotten.txt
git commit --amend --no-edit

2. 提交到了错误的分支

# 假设应该提交到 feature 分支，却提交到了 main
git branch feature                # 在当前位置创建分支
git reset --hard HEAD~1           # main 回退
git switch feature                # 切到 feature

3. 本地分支落后，想同步远程

git fetch origin
git rebase origin/main
# 或者
git pull --rebase origin main

4. 合并冲突

git status                        # 查看冲突文件
# 手动编辑冲突文件，删除 <<<<<<< ======= >>>>>>> 标记
git add <resolved-file>
git commit                        # 或 git rebase --continue

放弃合并：

git merge --abort
git rebase --abort

5. 不小心提交了敏感信息

如果还没推送，git reset --hard 即可。
如果已推送，必须改写历史：

git filter-repo --path secrets.txt --invert-paths
git push --force-with-lease

同时立即更换泄露的密钥，因为 Git 服务器可能仍留有副本。

6. 忽略文件不生效

git rm -r --cached .
git add .
git commit -m "fix gitignore"

.gitignore 只对未跟踪文件生效，已跟踪的文件需要先 rm --cached。

十、提交规范（Conventional Commits）

<type>(<scope>): <subject>

<body>

<footer>

常用 type：

type	说明
`feat`	新功能
`fix`	修复 bug
`docs`	文档变更
`style`	格式调整（不影响代码逻辑）
`refactor`	重构
`perf`	性能优化
`test`	测试相关
`chore`	构建 / 工具 / 依赖变更

示例：

feat(auth): 支持 OAuth 2.0 登录

- 新增 GitHub / Google 登录入口
- 补充 token 刷新逻辑

Closes #123

十一、实用技巧

# 快速查看某文件的最后一次修改
git log -1 --stat <file>

# 查找是哪次提交引入了某个字符串
git log -S "search-string" --source --all

# 查看两个分支的共同祖先
git merge-base main feature

# 比较工作区和某个提交
git diff <commit>

# 临时切换到某个提交查看，不切分支
git switch --detach <commit>

# 查看暂存区的具体内容
git diff --staged

# 统计每个作者的提交数
git shortlog -sn

# 找出未被合并的分支
git branch --no-merged

十二、配置文件位置

级别	路径
系统	`/etc/gitconfig`（Linux）/ `C:\Program Files\Git\etc\gitconfig`（Windows）
全局	`~/.gitconfig` / `%USERPROFILE%\.gitconfig`
仓库	`<repo>/.git/config`

优先级：仓库 > 全局 > 系统。

参考

官方文档：https://git-scm.com/docs
Pro Git（中文版）：https://git-scm.com/book/zh/v2
Conventional Commits：https://www.conventionalcommits.org/zh-hans/

关于本站开展技术架构迁移的说明

2026-10-03T00:00:00Z

为进一步降低站点运行成本、提升内容可维护性、扩大浏览器兼容范围，本站于2026年9月至10月对底层技术架构进行系统性迁移。本次迁移不涉及内容层与视觉层的整体改版，但涉及渲染方式、组件体系、样式组织、URL 规范、构建流程等基础机制的全面调整。现将迁移背景、主要内容及后续安排说明如下。

一、迁移背景

（一）原架构的局限。本站原采用 Vue 3 单页应用方案，构建产物依赖客户端 JavaScript 渲染。该方案在交互密集的应用中具有优势，但对以内容发布为主要目的的站点而言存在以下局限：

首屏渲染依赖脚本执行，禁用脚本的浏览器无法获取内容；
对早期浏览器（如 Internet Explorer 系列）兼容成本极高；
内容以组件形式组织，写作需要掌握 Vue 模板语法，创作门槛较高；
每次内容更新均需重新打包全量资源，发布流程偏重。

（二）本站定位的变化。随着本站内容以"备忘录""规范说明""公告"等长文为主，交互需求趋弱，静态内容发布需求趋强。原架构与站点定位之间的适配度下降。

（三）兼容性要求。本站明确将浏览器兼容范围扩展至 Internet Explorer 7 及以上的所有浏览器，原架构基于现代 JavaScript 特性，无法覆盖该范围。

基于以上三点，本站决定对技术架构进行调整。

二、迁移主要内容

（一）构建体系迁移。由 Vue 3 + Vite 方案调整为 Eleventy 3 + Nunjucks 方案。Eleventy 为静态站点生成器，在构建阶段完成全部页面渲染，输出纯 HTML、CSS 与少量辅助脚本。迁移后：

所有页面均为预渲染的静态 HTML；
站点可部署于任意静态托管服务；
构建产物不含应用级 JavaScript 框架代码；
内容更新仅重新生成对应页面。

（二）组件体系迁移。由 Vue 单文件组件调整为 Nunjucks macro。原 .vue 文件中以 props 传参、以 slot 分发内容的方式，统一改为 Nunjucks 的宏调用，参数以字典形式传入。以按钮组件为例，原写法为：

<GovButton variant="primary">提交</GovButton>

迁移后写法为：

{{ button({ text: "提交", type: "primary" }) }}

两种方式在职责上等价：均实现"一处定义、多处引用"。差异在于前者运行于客户端，后者运行于构建时。

（三）样式体系重组。原样式以 Vue 单文件组件内的 <style scoped> 形式就近维护，存在重复定义、难以全局复用的问题。本次调整将样式按用途分为三类：

基础样式：重置、变量、布局，全站始终加载；
组件样式：按组件粒度拆分独立文件，如 button.css、tag.css；
页面样式：按页面粒度独立维护，如 post.css、archive.css。

每个页面在 frontmatter 中声明所需样式文件，构建时按需拼装 <link> 标签，避免全站加载无关样式。

（四）URL 规范调整。原标签页 URL 使用原始中文字符，存在编码歧义、跨平台兼容性差的问题。本次调整引入拼音转换规则，将中文标签统一转换为带声调数字的拼音形式，例如：

原 URL：/tags/文章/
新 URL：/tags/wen2-zhang1/

针对拼音重名（如"文章"与"纹章"拼音相同）的情况，采用构建时预计算映射表的方式，按标签字典序为冲突项添加数字后缀，确保每条 URL 唯一。

（五）浏览器兼容扩展。本次迁移明确将兼容范围扩展至 Internet Explorer 7 及以上版本。主要策略包括：

输出产物不含 ES6+ 语法，脚本以 ES5 形式书写；
使用 jQuery 1.12.4 作为 DOM 操作与 AJAX 的兼容层；
补充 ie7.css 专用补丁样式，通过条件注释仅向 IE7 及以下加载；
布局以 float + inline-block 为基准，flex 仅作现代浏览器增强；
不使用 CSS 变量作为唯一值来源，均带 fallback。

需要说明的是，IE7 用户仅能获得静态内容阅读能力，动态功能（如评论、检索、发布后台）不在此兼容范围内。

（六）工程化完善。新增构建前清理步骤，每次构建均先删除旧产物目录，避免历史文件残留。同时补充：

站点地图（sitemap.xml）；
内容订阅（feed.xml）；
搜索引擎规则（robots.txt）；
自定义 404 页面。

（七）内容创作方式调整。文章由 Vue 组件形式调整为标准 Markdown 文件，正文中可直接引用 Nunjucks 宏、读取站点全局数据，无需编写脚本逻辑。组件调用与 Markdown 语法可混用，写作门槛降低。

三、迁移后效果

（一）内容为先。页面以纯 HTML 交付，禁用脚本的浏览器、早期浏览器、文本浏览器均可正常阅读。

（二）构建轻量。站点不再包含应用级 JavaScript 框架，构建产物体积显著下降，构建时间缩短。

（三）样式可控。样式按页面按需加载，避免了全站样式的冗余加载，也便于后续按组件粒度调整。

（四）URL 稳定。标签、归档、文章等各类页面 URL 规范统一，便于分享、收藏与搜索引擎收录。

（五）维护便利。新增文章仅需添加 Markdown 文件，无需改动路由、组件或构建脚本。

四、后续工作

（一）逐步将原站其他栏目内容迁移至新架构，保持 URL 结构一致性。

（二）针对现代浏览器补充增强功能，例如评论、检索、阅读进度指示等，以渐进增强方式提供，不影响基础阅读。

（三）持续监测 IE7 等早期浏览器下的可读性，发现问题及时在 ie7.css 中补充补丁。

（四）完善发布流程，探索基于 Cloudflare Workers 与 GitHub API 的在线发布方案，降低内容维护的技术门槛。

五、说明

本站为个人技术项目，本次迁移属技术架构调整，不涉及任何机构或组织的立场表达。视觉设计仍参照政府网站规范进行，旨在为用户提供规范、清晰、易读的信息服务。所有内容仅代表个人观点，与任何机构无关。

特此说明。

附：主要参考文件

简要说明

Eleventy：静态站点生成器，构建时渲染全部页面，输出纯 HTML。
Nunjucks：Mozilla 开发的 JavaScript 模板引擎，本站用于组件化与数据渲染。
jQuery 1.12.4：jQuery 1.x 系列末版，兼容 IE6 及以上浏览器。
条件注释：Internet Explorer 专属的 HTML 注释语法，用于向特定版本 IE 加载专用资源。

关于在 Markdown 中嵌入 Nunjucks 组件的说明

2026-10-03T00:00:00Z

本站的 .md 文件由 Eleventy 的 Nunjucks 引擎在构建时编译。正文中的 Nunjucks 模板语法会被解析执行，组件以 macro 的形式调用。现将使用方法说明如下。

一、基本用法

在 frontmatter 之后，正文中直接书写 Nunjucks 语法即可。使用组件前，需要先从组件文件导入对应的 macro：

{% from "components/button.njk" import button %}

{{ button({ text: "阅读全文", href: "/posts/hello/", type: "primary" }) }}

渲染结果是一个带样式的按钮链接。正文中的 Nunjucks 语法与 Markdown 可以混用，不会相互干扰。

二、条件渲染

Nunjucks 的 if 标签用于根据 frontmatter 或站点数据决定是否输出某段内容。

{% if description %}
<p>本文摘要：{{ description }}</p>
{% endif %}

实际效果：本页的 description 有值，所以下面的摘要会显示出来。

本文摘要：本站 Markdown 文件由 Nunjucks 编译，正文中可直接调用组件 macro、条件渲染与循环。

三、循环渲染

for 标签用于遍历数组，比如站点导航、文章标签。

<ul>
{% for item in site.navigation %}
  <li><a href="{{ item.url }}">{{ item.title }}</a></li>
{% endfor %}
</ul>

输出为：

四、嵌入组件

本站提供的组件均可在正文中直接调用。先导入，再调用：

{% from "components/alert.njk" import alert %}

{{ alert({ type: "info", title: "提示", content: "这是一条信息。" }) }}

实际渲染效果：

提示

这是一条信息。

标签组件同理：

{% from "components/tag.njk" import tag %}

{{ tag({ text: "Eleventy", href: "/tags/eleventy/", color: "default" }) }}

Eleventy

五、组件参数

所有组件都以字典形式传参，可选的键取决于组件定义。以 button 为例：

{{ button({
  text: "提交",
  type: "primary",
  size: "lg",
  block: true,
  disabled: false
}) }}

参数	类型	说明
`text`	string	按钮文字
`href`	string	有值时渲染为 `<a>`，否则为 `<button>`
`type`	string	`primary` / `secondary` / `success` / `danger`
`size`	string	`sm` / `md` / `lg`
`block`	boolean	是否占满整行
`disabled`	boolean	是否禁用

六、注意事项

（一）组件需要显式导入。Nunjucks 的 macro 不像 Vue 组件那样自动注册，必须在文章里用 from ... import ... 后再调用。

（二）字典里不能嵌套双花括号。以下写法是错的——字典内部不能再写模板表达式，需要先 set 再引用：

{% set href = "/tags/" + (t | tagSlug) + "/" %}
{{ tag({ text: t, href: href }) }}

（三）Markdown 里的 shell 语法可能被误解析。Nunjucks 会把花括号加井号当作注释开始标记，shell 脚本里取字符串长度的那种写法会触发 expected end of comment 错误。解决办法是用 `` 包裹那一行，或者改用等价的 shell 命令，例如 expr length "$str"。

（四）构建时编译。正文中的 Nunjucks 在构建阶段执行，输出纯 HTML。若 macro 名或参数拼写错误，会在构建时报错，而不是静默忽略。

（五）没有运行时状态。本站是静态站点，正文里不存在 Vue 那样的响应式状态。需要交互（比如切换显示）时，要借助 jQuery 或原生 JS，且只在现代浏览器中执行，IE7 只保证静态内容的可读性。

（六）不要写 style 块。文章内的样式用已有 CSS 类或内联 style 属性，不推荐在 Markdown 里写 <style>。

七、小结

Markdown 与 Nunjucks 的融合让静态内容具备了组件化能力。文章可以引用全局数据、复用 UI 组件、按条件或循环渲染结构化内容，同时保持构建产物是纯静态 HTML，兼容到 IE7。这使得一批需要在多篇文章里重复出现的结构，可以被抽成组件统一维护。

韵典综合平台

第一篇文章

关于本站对照国办发〔2017〕47号文开展设计规范调整的说明

一、调整依据

二、调整主要内容

三、调整后效果

四、后续工作

五、说明

关于在 Markdown 中嵌入 Vue 组件的说明

一、基本用法

二、条件渲染与列表渲染

三、嵌入组件

四、事件绑定

五、注意事项

六、小结

Node包管理器备忘录

一、换源

1.1 一键切换：nrm

1.2 手动切换

1.3 常用镜像源

1.4 一次性使用（不改配置）

1.5 项目级 .npmrc

1.6 私有源 + 公共源混用（scoped registry）

1.7 认证 Token 配置

1.8 换源失败的排查

二、其他 binary 镜像（换源只改 npm 包，不改 binary）

2.1 Node 版本管理器镜像

2.2 Electron

2.3 Puppeteer / Playwright

2.4 node-sass / sass-embedded

2.5 sharp / canvas

2.6 Cypress

2.7 全家桶模板

三、命令对照速查

四、锁文件

清理重装

CI 严格安装

五、依赖版本语义

六、脚本（scripts）

钩子

传参与环境变量

七、依赖管理

overrides / resolutions（强制覆盖版本）

依赖分析

八、npm 专属

九、yarn v1 专属

workspaces

常用

十、pnpm 专属

核心优势

常用

工作区

.npmrc 常用

十一、常见问题

1. ERR_OSSL_EVP_UNSUPPORTED（Node 17+）

2. EACCES 权限错误

3. peer dep 冲突（npm 7+）

4. 安装慢

5. 幽灵依赖

6. CI 报 lock 不一致

7. 强制项目使用某个包管理器

8. npm audit fix --force 引入 breaking change

十二、安全审计

参考

Linux 备忘录

一、换源

1.1 apt（Debian / Ubuntu）

1.2 常用 apt 镜像源

1.3 yum / dnf（RHEL / CentOS / Fedora）

1.4 pacman（Arch）

1.5 pip 换源

1.6 Docker 镜像加速

1.7 Go module 代理

1.8 Maven 换源

1.9 换源后必做

二、文件与目录

查找

三、文本处理

管道组合

四、权限

1. `ERR_OSSL_EVP_UNSUPPORTED`（Node 17+）

2. `EACCES` 权限错误

3. `peer dep` 冲突（npm 7+）

8. `npm audit fix --force` 引入 breaking change