isChinaUser：轻量级浏览器地区判断库
isChinaUser 是一款开源的前端浏览器地区识别工具，通过分析本地信号如语言、时区、字体等，帮助开发者进行前端环境判断，适用于出海项目、静态站和前端分流场景。
isChinaUser 是一个开源的前端浏览器地区识别工具，旨在帮助开发者判断当前浏览器环境是否更符合中国用户或中国大陆设备。它不依赖 IP 归属地查询，而是通过分析本地信号，如语言、时区、字体等，提供轻量级的环境判断结果。
在出海项目或跨境网站开发中，开发者经常需要根据访问者的地区进行页面跳转、镜像入口提示或合规说明。isChinaUser 作为一个前端环境判断库，可以帮助开发者实现这一需求，而无需接入服务端 GeoIP 库，从而降低成本。
isChinaUser 不是 GeoIP 服务，也不是精准定位工具。它通过读取浏览器和系统暴露的信号，如语言、时区、Emoji 渲染和中文字体等，来判断当前环境是否更像中国用户或中国大陆设备。如果手动启用网络探测，它还可以通过探针图片的可达性，辅助判断当前网络出口特征。
isChinaUser 如何判断环境？
- 语言与时区（基础信号）：读取
navigator.language和navigator.languages，判断首选或备用语言是否包含中文；同时读取系统底层的 Intl 时区，判断是否接近中国大陆常见时区。 - Emoji 渲染差异（设备探测）：利用不同系统和浏览器在特定 Emoji 渲染上的差异，进行轻量级设备特征识别。
- 本地字体探测（环境指纹）：通过 Canvas 检测浏览器是否能调用常见中文字体。
- 网络连通性（异步探测）：通过探针图片的可达性，辅助判断当前网络出口特征。
适合哪些场景：出海网站、静态站与前端分流
isChinaUser 适用于前端开发者与出海项目站长。它可以帮助开发者实现根据访问环境展示不同的产品说明、服务可用性提示或合规说明，或者文档站需要给疑似国内用户展示境内 CDN 镜像入口等功能。
isChinaUser 基本用法示例
项目可以通过 npm 安装 isChinaUser，然后在前端页面、静态站或轻量级 Web 应用里使用它进行展示逻辑判断。
npm i is-china-userimport { isChinaUser } from 'is-china-user'; if (isChinaUser()) { // 展示境内镜像入口、访问提示或本地化说明 } else { // 展示默认内容 }不能替代 GeoIP，也不是风控工具
isChinaUser 解决的是“前端先做一个大致判断”的问题，不是精准定位，也不是账号风控系统。它读取的是浏览器和系统环境信号，这些信号本身就可能被用户修改或被浏览器隐私功能干扰。
⚠️ 使用前要注意如果用户改过系统语言、时区，使用纯英文系统、非默认字体环境，或者开启了 Canvas 指纹保护，判断结果都可能不准。所以它不适合作为支付风控、账号封禁、地区限制或法律合规判断的唯一依据。
更合适的用法，是把它当成一个前端辅助信号：比如给静态站、文档站或轻量级 SaaS 做访问提示、镜像入口提示、展示内容切换。涉及数据合规、跨境限制或账号安全时，还是应该使用服务端 GeoIP、业务规则和日志数据一起判断。
