用途:当需要编写 JavaScript 代码、遵循 JavaScript 风格指南、格式化 JS 文件或创建 Node.js 脚本时,应用 Google JavaScript 风格指南的约定。资料注明 Google 建议迁移到 TypeScript,本指南面向尚未迁移的 JavaScript 项目。
主要能力:给出文件基础、模块系统、变量声明、格式化、数组与对象、类、函数、控制结构、现代特性、注释与 JSDoc、Node.js 相关、常见模式等规范。核心约定包括:文件名用小写、下划线或短横线、扩展名 .js;编码 UTF-8;缩进 2 个空格,禁止制表符与行尾空白;优先 ES Modules,导入路径需带 .js 扩展名,不使用默认导出,避免循环依赖;变量默认用 const,需要重新赋值时用 let,从不用 var,每次声明一个变量;大括号用 K&R 风格,控制结构必须带大括号;列宽 80 字符(import/export、长 URL、shell 命令、文件路径等例外);语句必须加分号;数组和对象字面量使用尾随逗号,不使用 Array、Object 构造函数;类字段在构造函数中定义,可用 @const、@private 等标注;回调优先箭头函数;注释用 // 与 /* */,类、方法、函数使用 JSDoc;异步优先 async/await 并处理错误。
使用方式:资料未提供安装命令或调用步骤,仅说明技能应按需检索参考文件,包括 references/advanced-features.md、references/jsdoc-guide.md、references/naming-conventions.md、references/disallowed-features.md;完整风格指南见 https://google.github.io/styleguide/jsguide.html。
限制:资料未说明支持的平台、收费或价格信息;资料建议迁移 TypeScript,本指南并非 TypeScript 规范;未提供自动化格式化或检查工具的具体用法。