zotero-chinese/styles · 上手攻略

仓库：zotero-chinese/styles
链接：https://github.com/zotero-chinese/styles
分类：academic-writing · 参考文献样式（CSL）
作者：spark
更新：2026-07-14

1. 这是什么

zotero-chinese/styles 是中文 Zotero 社区维护的 CSL 引用样式集合。CSL（Citation Style Language）是一种 XML 格式的描述文件，用来告诉 Zotero / JurisM / Papers / EndNote 等文献管理软件："参考文献应该长什么样、应该按什么顺序、用什么标点"。

仓库定位：「本仓库提供了一系列中文期刊和学位论文的 CSL 样式，其中大部分是由 GB/T 7714—2015 衍生的。」它不是 Zotero 本身，也不是某个期刊的官方网站——它是一份社区策展的、面向中文写作者（论文、学位论文、期刊投稿）的样式市集。当前 Stars 约 6.3k，周增长 +21，背后由 zotero-chinese.com 提供可视化样式商店和数据生成。

仓库的核心资产：

src/：每个样式一个独立子目录，里头是 [style-name].csl 文件本体，可选的 items.json / cites.json 测试条目
metadata.json / index.md：自动生成，驱动 zotero-chinese.com 商店前端，不要手改
配套脚本：pnpm dev / pnpm build / pnpm preview 用于本地预览与生成
协议：所有样式采用 CC BY-SA 3.0 Unported，可自由再分发但需署名 + 同协议共享

2. 解决什么问题

中文写作者（论文、学位论文、期刊投稿）最大的痛点之一是参考文献格式：

国标 GB/T 7714—2015 是国内最通用的参考文献格式（《信息与文献参考文献著录规则》），但它本身非常复杂，期刊、学位论文、专著、网络资源各有细则。
官方 CSL 仓库（citation-style-language/styles）虽然提供了部分 GB/T 7714 衍生样式，但覆盖不全，很多国内期刊（如《会计研究》《中国管理科学》）、学位论文（如清华、北大、上交、复旦、各学科自定样式）根本没有。
Word 模板里直接给样式 是另一种方案，但样式不可继承、不可移植、版本管理困难。
Zotero 自带的几个 GB/T 7714 衍生样式对中文混排支持不佳，比如「et al.」和「等」无法在同一条参考文献里根据条目语言自动切换。

zotero-chinese/styles 就是为了解决这些问题：

覆盖最广：涵盖大多数国内核心期刊 + 主流高校学位论文。
支持双语混排：很多样式能根据条目 language 字段自动在「等」和「et al.」之间切换。
与 Zotero 商店集成：通过 zotero-chinese.com/styles 一键点击下载安装。
社区维护：缺样式可以提 ISSUE 申请，作者认真响应。
CSL-M 扩展：使用 citeproc-js 提供的 CSL-M 扩展（仓库中样式会触发 "xxx.csl 不是一个有效的 CSL 1.0.2 样式文件" 警告，这是正常现象，忽略即可），能实现官方 CSL 不支持的复杂逻辑。

3. 快速安装（使用侧）

你大多数情况下不需要 clone 这个仓库——你只需要一个或几个 .csl 文件装进 Zotero：

3.1 通过商店网页安装（最推荐）

打开 https://zotero-chinese.com/styles/
在搜索框输入期刊名 / 学校名 / "GB/T 7714" 关键词
进入样式详情页，在「下载」小节点任意链接（GitHub 直链 / 国内镜像）
Zotero 会自动识别并提示安装，点击「Install」即可
在 Word 加载项里选择 Document Preferences → 选刚装的样式 → Refresh

3.2 手动下载安装

如果商店没收录，可以直接从 GitHub 取：

# 示例：下载"中国管理科学"样式
curl -L -o chinese-management-science.csl \
  https://raw.githubusercontent.com/zotero-chinese/styles/main/src/chinese-management-science/chinese-management-science.csl

然后在 Zotero 里：Preferences → Cite → Styles → 「+ Add a Style」→ 选刚下载的 .csl。

3.3 Gitee 镜像（国内加速）

仓库提供 Gitee 镜像，自动同步，国内下载更稳。

3.4 安装后必须做的事

如果样式支持双语混排（中文条目超过 3 个作者用「等」、英文用「et al.」），你需要：

为每条文献显式设置 language 字段： - 中文条目：zh-CN - 英文条目：en-US - 注意：必须是 ISO 代码，不能写「English」「中文」！
批量设置可用 delitemwithatt 插件：选中条目 → 右键 → 「自动设置语言字段」。
Word 加载项里点 Refresh。
如果仍异常：Zotero Word 工具条 → Document Preferences → Language 切换一下（English(US) ↔ 中文(中国大陆)），再 OK。

4. 核心用法（开发侧）

如果你要贡献新样式或修改样式，需要本地构建环境。

4.1 环境要求

Node.js（推荐 20+）
Git（含 submodule 支持）
pnpm（通过 corepack enable 启用，无需单独安装）

4.2 克隆并初始化

# --recursive 重要！仓库带子模块
git clone --recursive https://github.com/zotero-chinese/styles.git
cd styles

# 如果忘了 --recursive
git submodule update --init

# 启用 pnpm（如果未安装）
corepack enable

# 安装依赖
pnpm install

4.3 本地预览与构建

# 方式 1：仅生成预览结果（CLI 输出）
pnpm dev

# 方式 2：在浏览器中实时预览
pnpm dev:open

# 生成所有数据（用于站点前端）
pnpm build

# 预览某个具体 CSL 文件的渲染效果
pnpm preview "src/accounting-research/accounting-research.csl"

4.4 新增一个样式

按 CONTRIBUTING.md 规范：

在 src/ 下为你的样式建独立目录：src/your-style-name/
在里头放 your-style-name.csl，可选 items.json / cites.json（CSL-JSON 格式的测试条目）
<info> 段必须填的字段： - title：与样式名一致 - id：使用 https://zotero-chinese.com/styles/your-style-name 形式 - link rel="self"：与 id 一致 - link rel="template"：基于上游模板时保留 - link rel="documentation"：期刊/学校官方格式要求链接 - issn：期刊填 - summary：注明文件号 + 发布日期 - updated：有效时间格式

禁止手动改 metadata.json / index.md——它们会被脚本自动覆盖。

4.5 命名规范

期刊/学校名 / 标准名（如 "中国管理科学"）
学校院系用"学校 - 院系"（如 "清华大学 - 计算机系"）
本科论文在括号标"本科"；研究生不标
引用格式在括号标"顺序编码"或"著者-出版年"（如 "GB/T 7714—2015（顺序编码）"）

5. 典型适用场景

学位论文写作：覆盖清华、北大、上交、复旦等大多数高校自定样式
期刊投稿：覆盖国内主流期刊（经济、管理、理工、医学等）
国标 GB/T 7714 系列：各种衍生版（顺序编码、著者-出版年、本科、研究生等）
双语混排论文：自动在「et al.」和「等」之间切换
科研团队内部统一格式：选定样式后组员共用
跨学期/跨课题复用样式：比 Word 模板移植性强

不适用：非学术论文、专利申请文档（专利有专门的 CSL 但本仓库较少）、图书出版（出版社有自己的版式规范）。

6. 坑与注意

"不是有效的 CSL 1.0.2 样式文件" 警告——所有本仓库的样式在安装时都会弹这个警告，因为使用了 CSL-M 扩展（基于 citeproc-js），是正常现象，直接忽略即可。
language 字段必须填 ISO 代码——填「中文」「English」会让双语混排样式失效。这一步是本仓库 80% 排版异常的根因。
混排后必须 Refresh——修改 language 后在 Word 加载项点 Refresh；仍异常时切换 Document Preferences 的 Language 来回一次再 OK。
不要手动改 metadata.json / index.md——会被 pnpm build 覆盖，得不偿失。
Word 工具条消失 / 加载宏被取消：参见 README 末尾 FAQ 链接集合（zotero-chinese.com 百科全书）。
Zotero 同步配置和附件：用 JavaScript 备份/恢复配置很常见，README 给出了参考脚本。
样式更新滞后于期刊实际要求：学术期刊格式规范偶尔微调，发现样式不符合最新版期刊要求时，提 ISSUE 反馈。

7. 与同类对比

资源	优势	劣势
zotero-chinese/styles（本仓库）	中文覆盖最广、双语混排支持、社区维护	仍有部分小众期刊未收录、CSL-M 警告噪音
citation-style-language/styles 官方仓库	官方背书、英文世界最权威	中文样式极少、中文期刊几乎不覆盖
各期刊官网提供的 Word 模板	完全匹配期刊最新版	不能继承、不能移植、改起来繁琐
Zotero Style Repository Zotero 内置商店	一键安装	中文样式偏少，且是 GB/T 7714 基础款
EndNote 期刊内置样式	EndNote 用户友好	EndNote 不是开源、跨平台体验差、价格高

对比结论：如果你用 Zotero（开源、跨平台、免费）写中文论文，zotero-chinese/styles 几乎是唯一可用的、覆盖足够广的中文 CSL 来源。配合 jasminum（中文 PDF 识别）、delitemwithatt（批量改语言）、ZotFile（附件管理）等插件，体验完整体验优于 EndNote。

8. 一句话推荐结论

中文 Zotero 用户的样式市集——安装用商店页面，贡献用 GitHub Issue + PR，混排别忘了填 language 字段。

参考来源

仓库 README（2026-07-14 抓取）：https://raw.githubusercontent.com/zotero-chinese/styles/main/README.md
仓库主页：https://github.com/zotero-chinese/styles
贡献指南：https://raw.githubusercontent.com/zotero-chinese/styles/main/CONTRIBUTING.md
样式商店：https://zotero-chinese.com/styles/
Gitee 镜像：https://gitee.com/zotero-chinese-x/styles
GB/T 7714—2015 PDF：http://www.cessp.org.cn/a258.html
CSL 官方仓库：https://github.com/citation-style-language/styles
citeproc-js / CSL-M：https://citeproc-js.readthedocs.io/en/latest/csl-m/index.html

不确定处

各 .csl 文件的最新版本细节未逐个核对，提交前请进对应样式目录看 <info> 段 updated 字段。
部分样式对 Zotero 7 的兼容性未做完整测试，社区反馈基本良好但偶有 issue。
delitemwithatt 插件的"自动设置语言字段"功能在不同 Zotero 版本下行为可能略有差异，请以插件最新版 README 为准。