本文介绍如何将多层嵌套的州-城市 json 数据扁平化，并根据动态 url 参数（如城市名）精准匹配，一次性获取城市名称、所属州全称、州缩写 id 及描述信息，适用于 react 单页应用中的城市详情页开发。
本文介绍如何将多层嵌套的州-城市 json 数据扁平化，并根据动态 url 参数（如城市名）精准匹配，一次性获取城市名称、所属州全称、州缩写 id 及描述信息，适用于 react 单页应用中的城市详情页开发。
在处理类似美国各州及其下属城市的嵌套 JSON 数据时，直接使用 map().filter() 容易导致结果为二维数组（如 [[], [{...}]]），难以直接提取关联的州级字段（如 state 和 id）。正确做法是先扁平化再过滤——利用 Array.prototype.flatMap() 将所有 places 提升至同一层级，并携带其父级状态信息。
以下为完整、可落地的解决方案：
✅ 步骤一：预处理数据（推荐在模块顶层执行一次）
// states.json —— 你的原始 JSON 文件（注意：确保 city/state 字段无多余空格或统一处理）
import stateNames from './states.json';
// 扁平化：每个城市条目都附带所属州的 stateName 和 stateId
const allPlaces = stateNames.flatMap(({ state, id, places }) =>
places.map((place) => ({
city: place.city.trim(), // 统一去除首尾空格，提升匹配鲁棒性
description: place.description,
stateName: state.trim(),
stateId: id,
}))
);? 为什么用
flatMap？map()会生成嵌套数组（如[[], [{...}]]），而flatMap自动拍平一层，直接得到形如[{city: 'Elgin', stateId: 'IL', ...}]的一维数组，便于后续链式操作。
✅ 步骤二：在组件中动态过滤与渲染
import { useParams } from 'react-router-dom';
const CityDetailsPage = () => {
const { cityname } = useParams<{ cityname: string }>(); // 类型安全声明
// 安全过滤（支持空参/未命中场景）
const cityData = allPlaces.find(place =>
place.city.toLowerCase() === cityname?.toLowerCase()
);
if (!cityData) {
return <p>❌ 未找到城市 "{cityname}" 的相关信息。</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill11765" title="Expanso yaml-to-json"><img
src="https://img.php.cn/upload/skill/001/246/273/6adaf20dbae7c507.jpg" alt="Expanso yaml-to-json" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill11765" title="Expanso yaml-to-json">Expanso yaml-to-json</a>
<p>使用 Expanso Edge 管道将 YAML 输入转换为 JSON 格式。</p>
</div>
<a href="/xiazai/skill11765" title="Expanso yaml-to-json" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div>;
}
return (
<div className="city-details">
<h1>{cityData.city}, {cityData.stateId}</h1>
<p><strong>所属州：</strong>{cityData.stateName}</p>
<p><strong>简介：</strong>{cityData.description}</p>
</div>
);
};
export default CityDetailsPage;⚠️ 关键注意事项
-
空格与大小写敏感：原始 JSON 中
"Elgin "含尾部空格，务必使用.trim()或.toLowerCase()做标准化匹配； -
性能优化：
allPlaces在模块加载时计算一次即可，避免每次渲染重复扁平化； -
错误边界：始终检查
cityData是否存在，防止undefined渲染报错； -
路由配置示例（
App.tsx）：<Route path="/city/:cityname" element={<CityDetailsPage />} />
✅ 扩展建议（进阶）
若需支持模糊搜索（如输入 "elg" 匹配 "Elgin"），可替换 find() 为：
const matches = allPlaces.filter(place => place.city.toLowerCase().includes(cityname?.toLowerCase() || '') ); // 然后用 .map() 渲染多个结果
通过扁平化 + 精准过滤的组合策略，你不仅能优雅解决当前需求，还为未来支持多城市检索、分页、排序等功能打下坚实基础。
