百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
C

complete-hsk-vocabulary

> 编程语言
开源

完整的 HSK 2.0/3.0 (汉语水平考试) 词汇表 (Json 格式)

280 stars0 点赞3 次浏览
访问官网GitHub

工具介绍

完整的 HSK 2.0/3.0 (汉语水平考试) 词汇表 (Json 格式)


  • Example
    • Schema
  • Reference
    • Levels
    • Parts of Speech
  • Sources
  • Community
    • Contributing
    • Donations
      • How can I donate?
  • License

This project is an attempt to provide complete vocabulary lists for the HSK tests (Hanyu Shuiping Kaoshi - 汉语水平考试) for the Chinese language, both the previous version (2.0) and the newer one (3.0).

The data is presented in different files.

The main file - complete.json - features ALL words appearing in any level, either of the HSK 2.0 tests or the HSK 3.0 ones - thus, it's the complete list.

Each entry includes different types of information:

⚡️ Example

…

[!TIP] The exact same data exists in the minified/compressed complete.min.json, only without pretty-printing and with the abbreviations you'll find in the table below used instead of the full field names (e.g w for word, etc).

Schema

  • simplified: (→ s) corresponds to the main word/entry in Simplified Chinese characters (简化字)
  • radical: (→ r) the main radical (部首)
  • level: (→ l) includes information about the HSK levels in which the word in question appears (in the above example, it's new HSK 1, and the old HSK 3) - see below for reference. ⬇️
  • frequency: (→ q) the word's relative "frequency" ranking (the lower this number, the more common the word)
  • pos: (→ p) the different parts of speech the word corresponds to (if available) - see below for reference. ⬇️
  • forms: (→ f) the different "forms" of the word
    • traditional: (→ t) corresponds to the main word in Traditional Chinese characters (正體字)
    • transcriptions: (→ i) different transliterations/transcriptions
      • pinyin: (→ y) the Hanyu Pinyin (汉语拼音) romanization with tone marks
      • numeric: (→ n) same as above, only with numeric notation for the tones
      • wadegiles: (→ w) transliteration of the word in Wade-Giles (威翟式拼音)
      • bopomofo: (→ b) transliteration of the word in Bopomofo/Zhuyin (注音)
      • romatzyh: (→ g) transliteration of the word in Gwoyeu Romatzyh (国语罗马字)
    • meanings: (→ m) a list of dictionary definitions for the current words ( all meanings have been cleaned and sanitized - as much as possible - with the possible classifier annotations extracted and presented as a separate entry)
    • classifiers: (→ c) the list of measure words (classifiers) associated with the word form in question (if any)

[!NOTE] Wordlists by level

The same data has been divided by HSK level (different sets for the new and old ones), and also in 'exclusive' vs 'inclusive' (does it include just the new words for each level, or all of the words up to that level?). So, let's say you want to find the complete list for the new (HSK 3.0) level 2, you would go to: wordlists/inclusive/new/2.json (with the minified version, changing 2.json with 2.min.json)


Reference

Levels

Level HSK 2.0 HSK 3.0
1 old-1 (→ o1) new-1 (→ n1)
2 old-2 (→ o2) new-2 (→ n2)
3 old-3 (→ o3) new-3 (→ n3)
4 old-4 (→ o4) new-4 (→ n4)
5 old-5 (→ o5) new-5 (→ n5)
6 old-6 (→ o6) new-6 (→ n6)
7-9 --- new-7 (→ n7)

Parts of Speech

Code Meaning Code Meaning
a adjective ns place name
ad adjective as adverbial nt organization name
ag adjective morpheme nx nominal character string
an adjective with nominal function nz other proper noun
b non-predicate adjective o onomatopoeia
c conjunction p preposition
d adverb q classifier
dg adverb morpheme r pronoun
e interjection rg pronoun morpheme
f directional locality s space word
g morpheme t time word
h prefix tg time word morpheme
i idiom u auxiliary
j abbreviation v verb
k suffix vd verb as adverbial
l fixed expressions vg verb morpheme
m numeral vn verb with nominal function
mg numeric morpheme w symbol and non-sentential punctuation
n common noun x unclassified items
ng noun morpheme y modal particle
nr personal name z descriptive

Sources

  • Old HSK wordlists: https://github.com/clem109/hsk-vocabulary
  • New HSK wordlists: https://github.com/elkmovie/hsk30
  • Dictionary definitions: https://www.mdbg.net/chinese/dictionary (CC-CEDICT)
  • Radicals: https://github.com/skishore/makemeahanzi (dictionary.txt)
  • Frequency data: https://github.com/krmanik/HSK-3.0-words-list
  • Parts of speech analysis:
    • http://crr.ugent.be/programs-data/subtitle-frequencies/subtlex-ch (SUBTLEX-CH)
    • https://github.com/hankcs/HanLP (HanLP)

Community

In case you want to ask a question, suggest an idea, or practically anything related to this project - feel free! Everything and everyone is welcome.

Contributing

[!IMPORTANT] Only edit complete.json manually!

All other files (complete.min.json, level-based wordlists in wordlists/, etc.) are automatically generated via GitHub Actions when changes are pushed to main. The processing scripts live in scripts/ and are triggered automatically - you don't need to run them yourself.

If you notice anything wrong with the vocabulary data or have suggestions for improvements, feel free to:

  1. Fork the repository
  2. Edit only complete.json with your changes
  3. Submit a pull request

For questions, ideas, or bug reports, open an issue. Don't hesitate! :wink:

Donations

Given that this project (along with many others - most importantly, the Arturo programming language) is maintained in my own free time, if you think it's useful, you'd be more than welcome to donate and help me focus on open-source work that really matters. :-)

How can I donate?

There are different options:

  • GitHub Sponsors
  • Bitcoins

License

MIT License

Copyright (c) 2026 Yanis Zafirópulos (aka Dr.Kameleon)

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Issues· 8 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

Rubychinesechinese-characterschinese-languagechinese-simplified

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月18日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言