引入

import {
  getRandomString,
  uniqueFactory,
  checkStringLength,
  randomString,
  replaceAllPolyfill,
  cleanLineNumberPrefix,
  applySearchReplace,
  camelize,
  hyphenate,
  capitalize,
  titleize,
  lowerInitial,
  pascalCase,
  toUnicodeAt,
  toUnicode
} from 't-comm';

// 不支持 tree-shaking 的项目
import {
  getRandomString,
  uniqueFactory,
  checkStringLength,
  randomString,
  replaceAllPolyfill,
  cleanLineNumberPrefix,
  applySearchReplace,
  camelize,
  hyphenate,
  capitalize,
  titleize,
  lowerInitial,
  pascalCase,
  toUnicodeAt,
  toUnicode
} from 't-comm/lib/string/index';

// 只支持 ESM 的项目
import {
  getRandomString,
  uniqueFactory,
  checkStringLength,
  randomString,
  replaceAllPolyfill,
  cleanLineNumberPrefix,
  applySearchReplace,
  camelize,
  hyphenate,
  capitalize,
  titleize,
  lowerInitial,
  pascalCase,
  toUnicodeAt,
  toUnicode
} from 't-comm/es/string/index';

getRandomString

描述：获取随机字符串

参数：

参数名	类型	描述
length	number	字符串长度，默认 32

返回: string

字符串

示例

randomString()

randomString(16)

uniqueFactory

描述：创建唯一 ID 生成器工厂函数 返回一个函数，每次调用时生成递增的唯一 ID

参数：

参数名	描述
compName	组件名称，用于生成 ID 的一部分
prefix	ID 前缀，默认为 't'

返回: 返回一个生成唯一 ID 的函数

示例

const getUniqueId = uniqueFactory('button', 'my');
getUniqueId(); // 'my_button_0'
getUniqueId(); // 'my_button_1'
getUniqueId(); // 'my_button_2'

checkStringLength(str, [num])

描述：检查字符串长度

参数：

参数名	类型	默认值	描述
str	string		字符串
[num]	number	30	长度

示例

checkStringLength('123', 2) // true
checkStringLength('123', 3) // true
checkStringLength('123', 4) // false

randomString(length)

描述：获取随机字符串

参数：

参数名	类型	描述
length	number	字符串长度，默认 32

返回: string

字符串

示例

randomString()

randomString(16)

replaceAllPolyfill()

描述：polyfill for replaceAll

参数：

示例

replaceAllPolyfill()

cleanLineNumberPrefix(text)

描述：清理 AI 输出 search/replace 块时常带的行号前缀 AI 在生成搜索字符串时，有时会无意把行号也带上，导致与源文件无法精确匹配。 本函数支持 5 种常见格式：

• "12| code" → "code"
• "12 | code" → "code"
• "12 code" → "code" (多空格分隔，仅当首行匹配且行号递增时才认为是行号)
• "12: code" → "code"
• "12. code" → "code"

为避免误删（如某些 markdown / 注释开头是数字），仅当：

• 首行能匹配到行号格式
• 后续行行号严格递增（差值为 1） 时才视为带行号前缀，全部清理。

参数：

参数名	描述
text	原始字符串（来自 AI 输出的 search/replace 块）

返回: 清理后的字符串；不像行号前缀时原样返回

applySearchReplace(source, search, replace)

描述：在源代码中查找 search 并替换为 replace，按 3 级策略匹配 策略：

- 精确匹配：原样查找 search - 行级匹配：去除每行首尾空白后逐行对比（应对 AI 输出与源文件缩进不一致） - 子串匹配：查找首行 trim 后的子串位置，从该位置开始截取与 search 等长的范围替换

参数：

参数名	描述
source	源代码字符串
search	要查找的字符串（可能被 AI 带了行号前缀，函数会自动清理）
replace	替换为的新字符串（同上，自动清理行号前缀）

返回: 替换后的字符串；查找失败返回 null

camelize(str, handleSnake)

描述：横线转驼峰命名，如果第一个字符是字母，则不处理。

参数：

参数名	类型	描述
str	string	输入字符串
handleSnake	boolean	是否处理下划线，默认不处理

返回: string

处理后的字符串

示例

camelize('ab-cd-ef')

// => abCdEf

hyphenate(str)

描述：驼峰命名转横线命名：拆分字符串，使用 - 相连，并且转换为小写

参数：

参数名	类型	描述
str	string	输入字符串

返回: string

处理后的字符串

示例

hyphenate('abCd')

// => ab-cd

capitalize(str)

描述：字符串首位大写

参数：

参数名	类型	描述
str	string	输入字符串

返回: string

处理后的字符串

示例

capitalize('abc')

// => Abc

titleize(str)

描述：将每个单词的首字母转换为大写

参数：

参数名	类型	描述
str	string	输入字符串

返回: string

处理后的字符串

示例

titleize('my name is yang')

// My Name Is Yang

titleize('foo-bar')

// Foo-Bar

lowerInitial(str)

描述：首字母小写

参数：

参数名	类型	描述
str	string	输入字符串

返回: string

输出字符串

示例

lowerInitial('GroupId')

// groupId

pascalCase(str)

描述：用大驼峰，即 PascalCase 格式，来格式化字符串

参数：

参数名	描述
str	字符串

返回: PascalCase 的字符串

示例

pascalCase('ab-cd')
// AbCd

pascalCase('ab_cd')
// AbCd

toUnicodeAt(str, index)

描述：获取字符串指定下标的 unicode

参数：

参数名	类型	描述
str	string	字符串
index	number	unicode 的下标

返回: string

data

示例

unicodeAt('ABC', 1)

// -> '\\u0042'

toUnicode(str)

描述：获取字符串的 unicode

参数：

参数名	类型	描述
str	string	字符串

返回: string

data

示例

toUnicode('ABC')

// -> '\\u0041\\u0042\\u0043'