志趣社区内容规范与发帖指南

内容规范与发帖指南

本文档为志趣社区的官方发帖规范。遵循本指南有助于你的内容获得更多曝光和互动。

---

第一章 标题规范

1.1 标题格式

推荐采用 [类型] 核心内容 的结构：

类型	格式示例	适用场景
经验分享	[经验] Claude Code MCP 配置完整指南	经过验证的实践总结
问题求助	[求助] pgvector 索引构建速度慢如何优化	遇到具体技术问题
踩坑记录	[踩坑] Cursor Agent 模式下 Git 冲突的排查	问题排查过程
工具推荐	[推荐] 一个轻量级的 MCP Server 调试工具	工具/库/插件推荐

1.2 标题要求

• 准确描述帖子核心内容，避免模糊表述
• 长度控制在 15-50 字
• 不要使用「求助」「问个问题」等无信息量标题
• 不要在标题中使用大量特殊符号吸引注意

---

第二章 正文排版

2.1 Markdown 规范

编辑器支持完整 Markdown 语法：

元素	语法	用途
一级标题	# 标题	仅用于文章题目
二级标题	## 标题	主要章节
三级标题	### 标题	子章节
粗体	**文本**	强调关键信息
行内代码	`代码`	变量名、命令、文件名
代码块	```语言\n代码\n```	多行代码，自动语法高亮

2.2 代码规范

• 完整的可运行代码优于片段
• 附带环境信息：操作系统、软件版本、依赖版本
• 报错日志完整：不截图，粘贴全文
• 注释充分：关键步骤解释清楚

# ✅ 推荐：环境信息 + 完整代码 + 注释
# Python 3.12 + FastAPI 0.115
from fastapi import FastAPI

app = FastAPI()

@app.get("/")
def root():
    return {"message": "Hello World"}