Google's AngularJS Style Guide

• 语言: 英语
• 格式: .pdf
• 来源: github.com/fgaray

摘要

文档提供了Google内部使用AngularJS开发的风格指南。主要涵盖依赖管理、模块定义、控制器和作用域的使用、服务注册以及测试和结构最佳实践等内容。强调使用Closure提供的goog.require和goog.provide进行依赖管理，遵循JavaScript Style Guide，并推荐使用Jasmine + Karma进行测试。文档还提到了JSCompiler的使用、@ngInject的依赖注入技术以及Angular模块的结构建议。

AI总结

《Google's AngularJS Style Guide》旨在为使用Closure库的AngularJS应用提供推荐的编码风格和最佳实践，特别适用于Google内部工程师，但对外部开发者也有参考价值。以下是文档的核心内容总结：

### 1. Angular语言规则
- **依赖管理**：使用Closure的`goog.require`和`goog.provide`管理依赖，确保与Google BUILD规则兼容。
- **模块**：主应用模块应置于根目录；模块应通过“name”属性引用其他模块。
- **外部文件**：使用提供的Angular externs文件以支持JSCompiler的类型安全。
- **标志**：在JSCompiler中使用推荐的标志（如ANGULAR_COMPILER_FLAGS_FULL）以优化代码。

### 2. Angular样式规则
- **变量命名**：避免使用`$`作为变量名前缀，保留`$`用于Angular和jQuery内置属性。
- **自定义元素**：注意IE8对自定义元素的支持问题，可能需要额外的-ie8 hacks。

### 3.Angular开发技巧、窍门和最佳实践
- **测试**：推荐使用Jasmine和Karma进行单元测试，利用Angular的模块加载和依赖注入适配器。
- **应用结构**：将控制器放在嵌套子目录中，其他组件（如服务、指令）放在`components`目录中。
- **作用域继承**：了解原型链继承的细节，避免因原型链遮蔽导致的意外问题。
- **依赖注入**：使用`@ngInject`注解简化依赖注入，并避免混淆编译错误。

### 4. 最佳实践链接和文档
- **资源链接**：包括Angular的官方最佳实践和相关会议视频。

### 核心要点
- **模块化与依赖管理**：通过`goog.provide`和`goog.require`明确管理代码依赖，避免模块定义的不一致。
- **代码风格**：遵循Google JavaScript风格指南，避免使用`$`作为自定义属性或服务的命名前缀。
- **测试与结构**：推荐使用`controller as`模式，明确作用域绑定，同时注重应用的目录结构和组件分离。
- **工具与优化**：利用JSCompiler进行代码编译，确保代码的高效性和安全性。

该指南不仅为AngularJS开发提供了具体的代码风格建议，还强调了与Closure库和Google内部工具的集成，帮助开发者在大型代码库中更高效地工作。