开启word count插件的wordcount.countchinesecharacters: true配置后,状态栏显示“chinese: n”,仅统计cjk统一汉字区块(u+4e00–u+9fff等)字符,不含中文标点或全角数字。

VSCode 本身不显示中文字符数,必须靠 Word Count 插件 + 显式配置才能分出来。 它默认只报 Words 和 Chars,而 Words 对中文是“每个汉字算 1 个词”,Chars 是所有 Unicode 码点总数(含英文字母、标点、空格),都不等于“纯中文字符个数”。想单独看到“中文字符:XX 个”,得开一个隐藏开关。
Word Count 插件怎么开启中文字符单独统计?
插件作者提供了 wordcount.countChineseCharacters 配置项,但默认关闭。它一开,状态栏就多出 Chinese: N 字段,且只计 GBK/UTF-8 下的汉字、日文平假名/片假名、韩文音节等 CJK 统一区块字符(U+4E00–U+9FFF 等),不包含中文标点或全角数字。
- 打开
settings.json(Cmd+, → 右上角三个点 → Open Settings (JSON)) - 在花括号内加一行:
"wordcount.countChineseCharacters": true - 确保没误加
"wordcount.excludedLanguages": ["markdown"]这类排除项,否则整个统计消失 - 改完保存,按 Cmd+Shift+P → 输入
Developer: Reload Window重载窗口
为什么开了还是不显示 Chinese: ?
常见卡点不是配置写错,而是语言模式或文件内容没被识别:
- 右下角状态栏显示的是
Plain Text而非Markdown或Text:点击切换,或给文件加.md后缀 - 文件里全是英文或空行:插件不会硬塞
Chinese: 0,只有检测到至少 1 个中文字符才显示该字段 - 用了折叠区域(如
/// #region)或注释块:不影响,插件读的是编辑器最终渲染文本,不是源码 AST - 文件大于 10MB:插件主动降级,跳过所有统计(包括中文计数),可调大
wordcount.maxFileSize(单位 MB)
中文字符数和 Chars/ Words 到底差在哪?
拿这行测试:你好 world! 123
-
Chars: 13(U+4F60、U+597D、空格、w、o、r、l、d、!、空格、1、2、3)→ 所有 Unicode 码点 -
Words: 4(“你好”算 1 个词,“world”、“123”各 1,“!”单独成词)→ 英文按空格/标点切,中文每个字独立成词 -
Chinese: 2(仅 “你”“好”两个汉字)→ 其他如感叹号、空格、数字、英文字母全不算
注意:wordcount.includeNonWordChars 控制标点是否进 Words,但对 Chinese 字段完全无影响——它只认字符 Unicode 区块。
别指望状态栏显示“中文字数占比”或“去标点中文数”
Word Count 插件没有提供百分比、过滤标点后中文计数、或区分简繁体的配置。它的 Chinese 就是简单区块匹配,稳定但朴素。如果项目真要“正文纯汉字数”(比如剔除引号、破折号、书名号),得用外部脚本:grep -oP '\p{Han}' file.md | wc -l(需支持 PCRE 的 grep)。状态栏那行数字,只适合快速估算中文密度,不是校验工具。











