综合教程汇集开发中常用的工具、规范与实践经验,适合日常查阅。

Markdown 编写

本站博客文章与教程均使用 Markdown 编写,由 Rust 后端实时渲染为 HTML。

标题与段落

# 一级标题
## 二级标题

普通段落,空行分段。

代码块

```rust
fn main() {
println!("Hello");
}
```

链接与图片

[站内文章](/blog/chatgpt-deploy)
[外部链接](https://github.com/livissnack)
![示例图](https://example.com/demo.png)

表格

| 列 A | 列 B |
|------|------|
| 值 1 | 值 2 |

Emoji 表情

在 Markdown 中可直接输入 Unicode Emoji,例如:✅ 🚀 📦

常用写法:

  • :smile: 在部分编辑器中会补全为 😄
  • 直接粘贴表情符号到正文
  • HTML 实体:🚀 → 🚀

Git 版本管理

基础工作流

git status
git add .
git commit -m "描述本次修改"
git push origin main

分支协作

git checkout -b feature/blog-ui
# 开发完成后
git checkout main
git merge feature/blog-ui

提交信息建议写清楚「为什么改」,而非只写「改了什么」。

Docker 部署

本项目提供 Dockerfile,典型流程:

docker build -t live-crawler .
docker run -d -p 8080:8080 --name live-crawler live-crawler

注意挂载数据目录(如数据库、上传文件)时使用 -v 持久化。

接口调试

推荐使用以下工具测试本站 API:

工具用途
curl命令行快速验证
Postman / Apifox图形化接口调试
浏览器 DevTools查看网络请求与响应

示例:

curl "http://127.0.0.1:8080/api/blog/search-index"

前端工程化

  • 包管理:锁定 package-lock.json / pnpm-lock.yaml,保证团队环境一致
  • 代码规范:ESLint + Prettier,提交前自动格式化
  • 构建优化:路由懒加载、图片压缩、CDN 静态资源

详见 前端编码规范示例

博客与内容运营

Hexo 升级参考

若你使用 Hexo 维护独立博客,可参考本站文章 Hexo 升级版本依赖

npm install -g npm-check
npm-check -u

搜索与导航

本站首页顶栏支持文章搜索,索引由 /api/blog/search-index 提供。侧栏展示最新文章、分类、标签与归档。

AI 与效率工具

流媒体与爬虫

学习资源

主题链接
Vue 入门本站 Vue 教程
Rust 入门本站 Rust 教程
开源社区GitHub
友链导航本站友链

问题反馈

使用中遇到问题,欢迎通过侧栏社交图标联系作者,或在 GitHub 提交 Issue。