一、前置思考

1.1 重复劳动是最大的浪费

开发者的日常损耗:
  → 手写重复代码 (模板/样板)
  → 重复配置 (新模块/新页面)
  → 重复检查 (规范/格式)
  → 重复操作 (构建/发布/发版)

效能的本质:
  → 机器能做的交给机器
  → 人只做"创造性的判断"
  → 让工具链成为团队的第二生产力

1.2 效能工具的四层架构

L1 代码模板: 新页面/模块一键生成
L2 脚本自动化: 构建/检查/发布脚本化
L3 IDE 插件: 右键菜单/快捷操作/代码补全
L4 Git Hooks: 提交前自动检查/格式化

二、核心原理

2.1 代码模板体系

模板 = 结构化的"最佳实践快照"
  → 新页面模板: 组件结构 + 样式 + 路由注册
  → 新模块模板: 目录结构 + 接口 + 单测
  → 新服务模板: 类结构 + 生命周期 + 日志

模板化收益:
  → 新人 5 分钟创建标准页面 (原 30 分钟)
  → 团队代码风格自动统一
  → 减少低级错误 (漏注册/漏导入)

DevEco 模板: 自定义文件模板
  → File > New > 模板
  → 占位符: ${name} ${date} 等

2.2 脚本自动化

常用自动化脚本:
  构建: hvigorw assembleHap (打包)
  检查: cjlint (规范) / 单测 (质量)
  发布: 版本号 + 签名 + 上传
  流水线: CI 脚本串联全流程

Node/Python 脚本示例:
  批量创建页面:
    node create_page.js user_profile
    → 生成页面文件 + 注册路由 + 更新索引

关键: 脚本进仓库, 团队共享
  → package.json scripts 或 tools/ 目录
  → 一条命令完成重复操作

2.3 自定义 DevEco 插件

DevEco Studio 基于 IntelliJ 平台
  → 支持插件开发 (Kotlin/Java)

常用插件能力:
  1. 快捷操作: 右键"创建页面"向导
  2. 代码检查: 项目规范自定义检查
  3. 代码生成: 批量生成模板代码
  4. 导航增强: 资源/路由跳转

轻量替代: 不写插件, 用脚本 + 外部工具组合
  → 大多数团队场景脚本就够

2.4 Git Hooks 质量门禁

pre-commit hook: 提交前自动执行
  → 代码格式化 (cjfmt)
  → 静态检查 (cjlint 增量)
  → 禁止提交敏感信息 (密钥扫描)
  → 禁止大文件

commit-msg hook: 校验提交信息规范
  → 必须符合 Conventional Commits 格式
  → 必须 DCO 签署 (Signed-off-by)

pre-push hook: 推送前执行
  → 跑单元测试 (快速集)
  → 编译检查

团队落地: husky + lint-staged
  → 只检查本次改动文件, 快
  → hook 脚本随仓库共享, 全员生效

三、源码/API 深度解析

3.1 页面创建脚本

// tools/create_page.js —— 一键创建标准页面
// 用法: node tools/create_page.js user_profile
const fs = require('fs');
const path = require('path');

const name = process.argv[2];
if (!name) {
  console.error('用法: node create_page.js <页面名>');
  process.exit(1);
}

const pageDir = 'entry/src/main/ets/pages';
const fileName = name.charAt(0).toUpperCase() + name.slice(1) + 'Demo.ets';

// 标准页面模板
const template = `@Entry
@ComponentV2
struct ${fileName.replace('Demo', '')}Demo {
  @Local title: string = '${name}';
  @Local logs: string[] = [];

  build() {
    Column({ space: 12 }) {
      Text(this.title).fontSize(20).fontWeight(FontWeight.Bold)
      Scroll() {
        Column() {
          ForEach(this.logs, (l: string) => {
            Text(l).fontSize(11).lineHeight(18).fontColor('#24292F').width('100%')
          }, (l: string, i: number) => l + i)
        }.width('100%')
      }
      .layoutWeight(1).width('100%').scrollBar(BarState.Off)
    }
    .width('100%').height('100%').padding(16)
    .backgroundColor('#F6F8FA')
  }
}
`;

fs.writeFileSync(path.join(pageDir, fileName), template);
console.log('✅ 页面已创建: ' + fileName);
// 自动注册路由 + 更新 Index (省略)

3.2 Git Hooks 配置

# .husky/pre-commit —— 提交前检查
#!/bin/sh
echo "🔍 运行提交前检查..."

# 1. 格式化本次改动的 ets 文件
npx cjfmt --check "$(git diff --cached --name-only -- '*.ets')"

# 2. 静态检查 (增量)
npx cjlint --fix "$(git diff --cached --name-only -- '*.ets')"

# 3. 敏感信息扫描
if git diff --cached | grep -E "(sk-[a-zA-Z0-9]{20,}|password\s*=\s*['\"])" ; then
  echo "❌ 检测到疑似敏感信息, 已阻止提交"
  exit 1
fi

# 4. 更新暂存区 (格式化后)
git add -A

# .husky/commit-msg —— 提交信息规范
#!/bin/sh
msg=$(cat "$1")
if ! echo "$msg" | grep -qE "^(feat|fix|docs|style|refactor|perf|test|build|chore)(\(.+\))?: .+"; then
  echo "❌ 提交信息不符合 Conventional Commits 规范"
  exit 1
fi

3.3 脚手架工具

脚手架 (CLI) 设计:
  oh-cli create page <name>      # 创建页面
  oh-cli create module <name>    # 创建模块
  oh-cli build --target=release  # 构建
  oh-cli check                   # 全量检查
  oh-cli publish --beta          # 发布

实现:
  → Node.js + commander (命令行解析)
  → 模板引擎 (ejs/handlebars)
  → 文件系统操作 + git 集成

价值: 团队入口统一
  → 新人一条命令上手
  → 规范内建在工具里, 不需要靠人记

四、企业级实战落地

4.1 效能工具全景

层	工具	解决
模板	页面/模块/服务模板	重复代码
脚本	构建/检查/发布脚本	重复操作
插件	IDE 快捷向导	手工配置
Hooks	提交/推送门禁	规范落地
脚手架	统一 CLI	团队入口
文档	自动生成 API 文档	文档维护

4.2 完整示例：效能提升演示

@Entry
@ComponentV2
struct DevEfficiencyDemo {
  @Local savedMin: number = 0;
  @Local logs: string[] = [];

  private runFlow(): void {
    this.logs = [];
    this.log('⚡ 开发者效能工具演示');
    this.log('');
    this.log('① 模板: 创建标准页面');
    this.log('   oh-cli create page user_profile');
    this.log('   → 页面+路由+索引 3 秒完成');
    this.log('   (原手工: 12 分钟)');
    this.log('');
    this.log('② 脚本: 一键构建+检查+发布');
    this.log('   oh-cli publish --beta');
    this.log('   → 格式检查→单测→打包→上传');
    this.log('');
    this.log('③ Git Hooks: 提交前自动门禁');
    this.log('   pre-commit: 格式化+lint+密钥扫描');
    this.log('   commit-msg: 规范校验+DCO 检查');
    this.log('   → 错误提交被拦截在本地');
    this.log('');
    this.log('④ 团队成果: 人均日效率 +38%');
    this.log('   规范违规率 -80% · 新人上手 3 天');
    this.savedMin = 38;
  }

  build() {
    Column({ space: 12 }) {
      Text('⚡ 开发者效能演示').fontSize(20).fontWeight(FontWeight.Bold)
      Text('效率提升: +' + this.savedMin + '%').fontSize(13).fontColor('#0A7D73')

      Row({ space: 8 }) {
        Button('▶ 模拟效能流程').layoutWeight(1).height(40).fontSize(12)
          .onClick(() => this.runFlow())
        Button('清空').height(40).fontSize(12)
          .onClick(() => this.logs = [])
      }
      .width('100%')

      Scroll() {
        Column() {
          ForEach(this.logs, (l: string) => {
            Text(l).fontSize(11).lineHeight(18).fontColor('#24292F').width('100%')
          }, (l: string, i: number) => l + i)
        }.width('100%')
      }
      .layoutWeight(1).width('100%').scrollBar(BarState.Off)
    }
    .width('100%').height('100%').padding(16)
    .backgroundColor('#F6F8FA')
  }
}

4.3 效能落地清单

1. 模板先行: 高频重复的结构先模板化
2. 脚本进仓: 构建/检查/发布脚本化, 团队共享
3. Hooks 门禁: 格式化/规范/敏感信息提交前拦截
4. 脚手架统一: 一条命令创建/构建/发布
5. 数据量化: 记录提效指标, 让收益可见
6. 持续迭代: 团队吐槽最多的环节优先自动化

五、问题排查与性能优化

问题	原因	解决
Hook 拖慢提交	检查全量文件	只检查本次改动 (lint-staged)
模板不合用	模板死板	参数化 + 可配置
脚本平台差异	环境不一致	统一 Node 版本 + CI 执行
新人不用工具	文档缺失	上手文档 + 命令演示
插件崩 IDE	插件冲突	插件隔离测试
工具闲置	没有收益数据	量化提效, 团队宣讲

5.1 效能优化进阶

1. 检查加速: 增量检查 + 缓存 + 并行
2. 模板参数化: 名称/风格/依赖可配置
3. 一键体验: 新环境一条命令装好工具链
4. 反馈闭环: 使用统计 → 优化工具
5. 团队共建: 人人可提交工具改进

六、高阶总结与最佳实践

1. 自动化优先：重复的事交给工具，人专注创造。
2. 模板即规范：把最佳实践固化成模板，风格自动统一。
3. Hooks 是门禁：错误在提交前拦截，比事后修复便宜百倍。
4. 脚手架统一入口：一条命令完成创建/构建/发布，新人零门槛。
5. 量化提效：用数据证明工具价值，团队才会用起来。

一句话记住：开发者效能 = 模板消灭重复 + 脚本串起流程 + Hooks 守住规范 + 脚手架统一入口，让工具链成为团队的第二生产力。