最近在整理项目文档时遇到一个让我血压飙升的问题——从微信、PDF 或网页复制过来的文本，总是夹杂着各种「不三不四」的字符。不过，明明看起来是正常的英文和数字，但粘贴到代码里就报错，搜索也搜不到。

排查了半天罪魁祸首居然是全角字符。说起来，全角的 ＡＢＣ 和半角的 A娱乐 看起来几乎一样。但在程序眼里完全是两个不同的东西。这种「视觉混淆」在开发中造成的坑，不少人都踩过。

再看痛点，全角字符的「隐形炸弹」

在中文技术社区混久了你会发现全角/半角问题是个「经典老番」。无论是的观点是，

• 从微信聊天记录复制代码片段
• 从 PDF 文档提取文本
• 从 Word 粘贴到终端或编辑器
• 处理使用者提交的表单数据

全角字符总能以各种姿势给你「惊喜」。最典型的是——使用者从某个中文输入法切到英文模式时标点符号还是全角的。于是 if 变成了 if直接编译报错。

传统方法无非是：手动逐个替换、写个简单正则替换，或者用一些重量级工具。

为什么不用现成的库？按理说，

1. 体积问题: 为了一个转换功能引入整个库。对轻量级工具来说有点「奢侈」。
2. 依赖管理: 独立开发的小工具，能少一个依赖就少一个。
3. 可控性: 自己实现，遇到特殊字符可以随时调整映射规则。

I decided to use AI to build a pure front‑end,zero‑dependency tool.

和 AI 协作：从「能用」到「好用」

至于第一轮。给 AI 提需求

/* Prompt:
- 全角转半角
- 半角转全角
- 处理全角空格 U+3000
- 处理全角标点 U+FF01–U+FF5E
- 特殊货币符号映射
- 不要修改原字符串
- 处理 null/undefined 输入 */
export function toHalfWidth { /* ... */ }
export function toFullWidth { /* ... */ }
*/

The first code generated by AI could run,but had issues:

function toHalfWidth {
if return str;// 问题：null 和 '' 都返回 null
return str.replace {
return String.fromCharCode - 0xFEE0);})，}

This “AI trap” mixed up empty strings and null`,and regex was not flexible enough for special symbols.

第二轮这方面。调优边界情况

var FWSpecial = {
0xFFE0: '¢',0xFFE1: '£',0xFFE2: '¬',};不过，function toHalfWidth {
if return '';var out = '';for {
var c = str.charCodeAt;if {
out += ' ';} else if {
out += String.fromCharCode;} else if {
out += FWSpecial;
} else {
out += str.charAt;按理说，}
}
return out;}

This version was more reliable,but still had unnecessary type checks.

再看第三轮。处理「看不见」的坑

The real problem surfaced during testing with text copied from WeChat:

• The full‑width space U+3000 was converted correctly.
• The full‑width comma “，” and period “。” were left untouched.
• This is because those punctuation marks belong to CJK punctuation block,not full‑width ASCII block .
• A design decision was made: only convert U+FF01–U+FF5E and U+3000;leave CJK punctuation unchanged so Chinese typography stays intact.

Tecnical Implementation Details

The core logic boils down to a simple mapping table plus iteration:

const FWSpecial = {
0xFFE0: '¢'。0xFFE1: '£',0xFFE2: '¬',};

export function toHalfWidth { if return '';let out = '';for { const c = str.charCodeAt;if { out += ' ';// Full‑width space } else if { out += String.fromCharCode;// Full‑width ASCII variants } else if { out += FWSpecial;// Special currency symbols } else { out += str.charAt;// Preserve or characters } } return out;}

export function toFullWidth{ ifreturn'';let out=''，按理说，for{ const c=str.charCodeAt;if{out+=String.fromCharCode;}else if{out+=String.fromCharCode;}else{out+=str;不过，} } return out;}

The offset of {{{{{{{` is simply     `— difference 娱乐ween Unicode positions of full‑width and half‑width ASCII characters.

心得与经验

1. AIs 擅长构造骨架，却难对抗边界条件。
2. PROMPT 必须具体化。老实说，
3. TDD + 对话迭代加速修正过程。
4. AIs 经常过度设计，需要人工筛选必要功能。

适用场景

• 数据清洗：- 从任何渠道复制而来的文本都需要标准化。
• 代码修复：- 使用者提交代码时自动消除隐藏错误。
• 文档规范化：- 保持文档内部一致性，提高可读性。

小结

.

---

© ©