isChinaUser：轻量级前端工具，不靠 IP 也能识别国内用户

isChinaUser 是一款开源浏览器地区识别工具，通过语言、时区、字体等环境信号，在前端判断用户是否更像中国用户，无需 IP 或服务端支持。

不依赖 IP 的前端地区识别方案

isChinaUser 是一款开源的浏览器环境识别工具，旨在帮助前端开发者判断当前访问者是否更像来自中国大陆的用户或设备。与常见的 IP 归属地查询不同，它默认不依赖 IP，也不需要服务端 GeoIP 数据库，而是通过语言、时区、Emoji 渲染和中文字体等本地信号，给出一个轻量级的判断结果。

对于出海项目或跨境网站，开发者经常需要根据访问者的大致地区来调整页面跳转、镜像入口或合规提示。传统做法多依赖服务端 GeoIP，但对于纯前端部署的静态站、文档站或轻量级 SaaS，接入服务端逻辑会增加额外的成本和复杂度。

简单来说，isChinaUser 并非 GeoIP 服务，也不是精准定位工具，而是一个基于浏览器语言、系统时区、Emoji、字体以及可选网络探针的前端环境判断库。如果手动启用网络探测，它还能通过探针图片的可达性，辅助判断网络出口的特征。

工作原理：多维度环境信号综合分析

常规的地区识别依赖 IP，而 isChinaUser 采用“环境特征组合”策略。当页面加载时，它会读取浏览器和系统暴露的几类信号，以此判断当前环境是否更接近中国用户或中国大陆设备。

• 语言与时区（基础信号）：读取 navigator.language 和 navigator.languages，检查首选或备用语言是否包含中文；同时读取系统底层的 Intl 时区，判断是否接近中国大陆常见时区（如 Asia/Shanghai 或 UTC+8）。
• Emoji 渲染差异（设备探测）：利用不同系统和浏览器在特定 Emoji 渲染上的差异，进行轻量级的设备特征识别。
• 本地字体探测（环境指纹）：通过 Canvas 检测浏览器能否调用常见中文字体，例如 DengXian、FangSong、仿宋、等线等。
• 网络连通性（异步探测）：这是可选的异步方法。如果手动调用，它会尝试加载特定探针图片，根据探针的可达性，辅助判断网络出口特征。

适用场景：出海网站、静态站与前端分流

该库的核心受众是前端开发者与出海项目站长。它的价值不在于替代服务端风控，而是为前端展示逻辑提供低成本的辅助判断信号。

例如，当 SaaS 官网需要根据访问环境展示不同的产品说明、服务可用性提示或合规说明，或者文档站需要为疑似国内用户展示境内 CDN 镜像入口时，可以在引入该库后，用 if (isChinaUser()) 这类条件判断作为前端展示逻辑的一部分。

在默认同步判断模式下，isChinaUser 主要依赖本地浏览器信号，不会主动发起网络探测请求；如果手动开启网络探针，则需要额外加载探针图片，结果也会受到网络环境、代理和浏览器隐私设置的影响。

基本用法示例

项目可通过 npm 安装，适合在前端页面、静态站或轻量级 Web 应用中进行展示逻辑判断。

默认的 isChinaUser() 主要依赖本地浏览器环境信号。如果需要加入网络可达性判断，可以按项目文档再调用异步网络探测方法。

重要提示：不能替代 GeoIP 或风控工具

isChinaUser 解决的是“前端先做一个大致判断”的问题，并非精准定位，也不是账号风控系统。它读取的是浏览器和系统环境信号，这些信号可能被用户修改，或因浏览器隐私功能而失真。

⚠️ 使用前请注意：如果用户修改过系统语言或时区、使用纯英文系统、非默认字体环境，或开启了 Canvas 指纹保护，判断结果可能不准确。因此，它不适合作为支付风控、账号封禁、地区限制或法律合规判断的唯一依据。

更合适的用法是将其作为前端辅助信号，比如为静态站、文档站或轻量级 SaaS 提供访问提示、镜像入口提示或内容切换。涉及数据合规、跨境限制或账号安全时，应结合服务端 GeoIP、业务规则和日志数据综合判断。