Google开源项目风格指南-ReadTheDocs.PDFVIP

Google 开开开源源源项项项 目目目风风风格格格指指指南南南 Release Nov 18, 2017 Contents i ii • 在线文档托管在 ReadTheDocs : 在线阅读最新版本 • 中文风格指南 GitHub 托管地址 ：zh-google-styleguide Note: 声明. 本项 目并非 Google 官方项 目, 而是 由国内程序员凭热情创建和维护. 如果你关注的是 Google 官方英文版, 请移步 Google Style Guide 每个较大的开源项 目都有 自己的风格指南: 关于如何为该项 目编写代码的一系列约定 (有时候会比较武断). 当 所有代码均保持一致 的风格, 在理解大型代码库时更为轻松. “风格” 的含义涵盖范围广, 从 “变量使用驼峰格式 (camelCase)” 到 “决不使用全局变量” 再到 “决不使用异常”. 英文版项 目维护 的是在 Google 使用 的编程风格指南. 如果你正在修改 的项 目源 自Google, 你可能会被引导至 英文版项 目页面, 以了解项 目所使用的风格. 我们 已经发布了五份 中中中文文文版版版 的风格指南: 1. Google C++ 风格指南 2. Google Objective-C 风格指南 3. Google Python 风格指南 4. Google JSON 风格指南 5. Google Shell 风格指南 中文版项 目采用 reStructuredText 纯文本标记语法, 并使用 Sphinx 生成 HTML / CHM / PDF 等文档格式. • 英文版项 目还包含 cpplint - 一个用来帮助适应风格准则 的工具, 以及 google-c-style.el, Google 风格 的 Emacs 配置文件. • 另外, 招募志愿者翻译 JavaScript Style Guide 以及 XML Document Format Style Guide, 有意者请联 系 Yang.Y.