Google's AngularJS Style Guide

《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内部工具的集成，帮助开发者在大型代码库中更高效地工作。