共计 4206 个字符,预计需要花费 11 分钟才能阅读完成。
读韩愈那句「云横秦岭家何在,雪拥蓝关马不前」的时候,我总会停一下:蓝关到底在今天什么地方。人在海外,手里往往没有一套可以随时翻的历史地图集,手机搜出来的又多是单张插图,年份对不上,城名也对不上。
江山时序就是为这件事做的一张网页地图。仓库在 DeanChensj/jiangshan-map,官方演示在 https://deanchen.me/jiangshan-map/。它把从公元前 403 年三家分晋到今天的疆域、古城、关隘和人物行迹放进同一张可拖动的图里,点一座城能看它换过哪些名字,也可以顺着一首诗里的地名连成一条路线。
2026 年 11 月 17 日下午约 14:55(北京时间),我打开 GitHub 日榜,它排在第 7,页面写着当天加了 288 星。同一时间用 GitHub 接口读到总星数 7,247,Fork 870,许可证是 GPL-3.0。项目说明里写的是 18 个历史时期、198 幅疆域快照;11 月 13 日发布了 v1.3.0,我本地克隆到的是默认分支提交 897b9ad(提交说明时间换算成北京时间是 11 月 16 日 18:21),比这份发布说明又晚了几天的界面小修复。
下面按我实际打开的顺序写:先看官方演示的默认画面,再用两条官方示例深链落到蓝关和苏轼的贬谪路线,然后用搜索框找长安,再在 Linux 测试机上本地跑通。
🍎 实测环境:官方演示在我的 Linux 测试机浏览器里打开;本地用 git clone 之后,在仓库目录里执行 python3 -m http.server 18080,只绑本机 127.0.0.1。官方文档写的默认端口是 8000,我改用 18080,避免跟测试机上可能占用的端口撞车。实测时间是 2026 年 11 月 17 日 14:59 至 15:04(北京时间)。项目说明写得很清楚:图上的历史疆域是示意性近似,不是测绘成果,不能拿来当精确边界引用。代码和项目自行整理的数据用 GPL-3.0;郡、州、府这一层边界来自 CHGIS V6 等资料,官方写明仅限学术、非商业用途,含该层的截图也受同一条款约束。因此正文没有放入地图界面截图,也不提供数据导出。

打开官方演示 → 用深链或搜索落到地点 → 需要时在本地打开同一份页面
PART 01
打开官方页,默认落在战国
浏览器打开 https://deanchen.me/jiangshan-map/,不用登录。我等到地图色块和底部时间轴都出来之后,默认年份是公元前 403 年,右侧标题是「战国」,时间轴上写着「周威烈王二十三年」。
地图上能同时看到秦、楚、齐、燕、赵、魏、韩,还有周、中山、义渠、越、巴这些政权的色块。画面中央弹出一条浮签,写的是这一年的大事:周威烈王命韩、赵、魏为诸侯,也就是三家分晋。左下角有图例,底栏可以从战国一路拖到现代。
页面标题是「江山时序 · 中国历史地图时间轴(战国至现代历代疆域、州郡政区与古今地名沿革)」。左上角有搜索框,提示文字是「搜人物 / 多人同看 / 古今地名 / 年号」。
如果你只是先看一看各朝版图怎么变,拖底部时间轴就够了。我想做的是另一件事:把诗里的一个地名,准确落到某一年。
PART 02
用深链直接落到 819 年的蓝关
项目中文说明里给了一条现成的地址,对应韩愈「雪拥蓝关马不前」:
https://deanchen.me/jiangshan-map/?year=819&place=蓝关
我在浏览器里直接打开它。等地图和右侧卡片都出现之后,地址栏被改写成了:
https://deanchen.me/jiangshan-map/?year=819&trace=109.480,34.030
年份还是 819,place=蓝关 变成了一对坐标。底部时间轴写的是「公元 819 年 · 唐宪宗元和十四年」,地图中央能看到「唐」,蓝关的位置打了标。
右侧打开「点地溯源 · 古今政区沿革」卡片,标题是「蓝关:陕西省、今西安蓝田」,下面同样写着 109.480°E,34.030°N。卡片按时期列出这座点的沿革,唐代这一段写的是关内道,邻近古城是蓝田。卡片里还列了几条跟蓝田有关的史事,比如 819 年韩愈贬潮州经过蓝关。这些文字来自项目自己的整理,对史实有疑问,应以史籍和项目的纠错入口为准。
这条深链的好处很直接:不用先猜该搜哪个词,把年份和地名写进网址,别人点开就能看到同一画面。
PART 03
再画苏轼「黄州惠州儋州」这条路
说明里还有一条跨年路线,对应苏轼「问汝平生功业,黄州惠州儋州」:
https://deanchen.me/jiangshan-map/?year=1079,1080,1094,1097&place=湖州,黄州,惠州,儋州
我第一次打开后大约等了 9 秒就截图,当时左下角只写「行迹路线 · 共 3 站」,图上能看到湖州(1079)、黄州(1080)、惠州(1094),路程显示约 1318 公里,儋州还没有出现,地址栏也被收成了 ?year=1079。
同一条地址再打开一次,等到网络空闲后再多留大约 12 秒,左下角改成了「行迹路线 · 共 4 站」,儋州(1097)出现在琼州一带,全程约 1958 公里。四站顺序是:湖州(1079) → 黄州(1080) → 惠州(1094) → 儋州(1097)。地址栏仍然显示 ?year=1079,但图上的四年站点和路线都在。
所以这类多站深链,不要看第一眼的不完整画面就下结论。我的经验是:等左下角的站数和项目说明里的站数一致,再看路线。
若想看的不是这四站,而是苏轼一生的行迹,官方还支持 ?person=sushi。我打开后,页面标题变成「苏轼生平纪事地图」,地址栏是 ?year=1037&person=sushi,右侧「点人溯事」卡片写着苏轼(1037–1101),从 1037 年眉州开始往下列站。

PART 04
自己按 / 搜索「长安」
不一定每次都拼深链。在官方首页,我按下键盘 /,左上角搜索框被唤醒,接着输入「长安」。
下拉列表第一条是「长安 今西安」,右侧标签是「西汉 · 古城」。下面还能看到青龙寺、西汉都城长安、隋代大兴(长安)、武周、武则天等条目。我直接按回车,走的是第一条。
回车之后,年份被切走了。地址栏变成 ?year=-100&trace=108.941,34.341,页面标题改成「西汉历史地图(前202 — 25)疆域政区与古今地名 · 江山时序」。底部写的是「公元前 100 年 · 西汉武帝天汉元年」。右侧卡片标题是「陕西省 · 西安」,坐标 108.941°E,34.341°N。地图上能看到「汉」,以及长安附近的标注。
在战国画面里搜「长安」并回车,年份不会停在公元前 403 年,而会跳到这条结果对应的西汉。若你本来想在当前年份里看长安,需要先看清列表里每一条的时代标签,再决定点哪一条。
PART 05
在自己的电脑上打开同一份页面
官方演示已经能用。如果想离线改、自己托管,或者核对某一版代码,可以把仓库跑在本地。项目是纯静态网页,说明里写着:不需要安装依赖,也不需要构建。
我实际敲的是:
git clone https://github.com/DeanChensj/jiangshan-map.git
cd jiangshan-map
python3 -m http.server 18080 --bind 127.0.0.1然后在浏览器打开 http://127.0.0.1:18080/。官方文档的示例是 python3 -m http.server 8000,再打开 http://localhost:8000。端口换成 8000 也一样,只要没被占用。
本地默认页和官方演示一样,也是先落到战国。同一条蓝关深链在本地同样可用:
http://127.0.0.1:18080/?year=819&place=蓝关
打开后地址栏同样被改写成 ?year=819&trace=109.480,34.030,右侧卡片标题仍是「蓝关:陕西省、今西安蓝田」。把本地页面和刚才的官方演示对过,主画面一致。
官方还提供 Docker 方式:docker compose up -d --build,再打开 http://localhost:8008。这一次我没有走 Docker,只用了上面的 Python 静态服务器。
用不了,停掉那个 python3 -m http.server 进程即可。仓库目录也可以直接删掉,它没有往系统目录里装软件。
PART 06
还会用到的按键,以及我没跑过的部分
我亲自试过、能确定的只有这些:/ 唤醒搜索,回车走列表当前项,以及官方文档里的 year、place、person 深链。

▲ 示意图:在页面里按 /,左上角搜索框会被唤醒。水彩示意,按键以正文实测为准。
其余快捷键我没有逐项核对,这里按官方中文说明摘下来,方便对照:左右方向键或底栏的 ‹ / › 跳到上一或下一节点,按住 Shift 再按左右键一次进退 10 年;空格是自动播放或暂停;Esc 关闭弹窗或清除高亮。
页面右上角有「繁」和「EN」。官方说明里,繁体界面是 ?lang=zh-tw,英文界面是 ?lang=en。这两种语言界面我这回没有切换实测。
仓库还带命令行截图脚本和 MCP 接口,说明里的例子是:
python3 skills/jiangshan-atlas/scripts/jiangshan.py --year 819 --place 蓝关 --out /tmp/languan_819.png这条命令我没有跑。若你要用,以仓库当前文档为准。
· · ·
我自己会继续留着官方演示的书签,读到诗里的地名就先用深链或搜索对一下位置;需要自己托管或核对代码时,再开本地静态服务器。地图上的边界仍是示意,引用史实要以史籍为准。
相关阅读:如果想在自己的网页里放一张能算公式的表,可以看 在自己网页里放一张会算公式的表格:Univer 1.5 实测,从空项目做到回国预算表。若要在本地检查网页交互,可以看 用 Modern Web Guidance 本地扫一份旧留言页:回车提交会误伤中文输入法。
参考资料:
- 项目仓库:https://github.com/DeanChensj/jiangshan-map
- 官方演示:https://deanchen.me/jiangshan-map/
- 中文说明(含深链示例、本地运行、数据来源与授权):仓库内
README_ZH.md - v1.3.0 发布说明:https://github.com/DeanChensj/jiangshan-map/releases/tag/v1.3.0
- GitHub 接口读取星数的时间:2026-11-17 14:57(北京时间),当时为 7,247 星




