无障碍编程不是附加功能,而是尊重每位开发者认知方式的基本承诺。视障开发者依赖屏幕阅读器将代码转为语音或盲文,而变量命名恰恰是他们理解逻辑流的第一道门槛。
模糊缩写是隐形障碍。当屏幕阅读器念出“usr”“tmp”“idx”,它无法传递语义,反而迫使开发者反复回溯上下文猜解。相比之下,“userProfile”“temporaryBackupFile”“itemIndex”能直接建立清晰心智模型——每个词都承载可预测的含义,语音输出时自然形成逻辑分段。
驼峰命名与下划线命名对屏幕阅读器友好度不同。阅读器通常将驼峰名称拆分为独立音节:“userProfile”读作“user profile”,而“user_profile”可能被识别为“user underscore profile”,增加冗余停顿。更优选择是语义完整、大小写自然分隔的驼峰式,如“isLoggedIn”比“is_logged_in”更流畅。
避免依赖视觉隐喻。像“redFlag”“bluePrint”“lightweight”这类词,在纯听觉场景中失去参照系;而“validationFailed”“systemArchitecture”“lowMemoryUsage”则直指功能本质,无需视觉联想即可理解。

本图基于AI算法,仅供参考
数字和特殊符号需谨慎。编号变量如“data1”“data2”无法体现差异,应改用角色化命名:“incomingRequestData”“cachedResponseData”。下划线若用于分隔,确保不连续出现(如“__private”易被误读为长停顿),优先用语义动词或名词组合替代。
命名一致性本身即是一种无障碍。同一模块中,“userId”“userName”“userEmail”形成可预期的语音模式,帮助听觉记忆快速匹配;若混用“uId”“name”“emailAddr”,节奏被打断,认知负荷陡增。
真正包容的命名,不是为视障者“特设规则”,而是回归编程本质:用人类语言准确描述意图。当每个变量名都能在耳边自解释,代码便不再依赖视力,而成为所有人共同书写的清晰对话。