企业官网建设流程全解析

1. React 依赖治理为什么总在深夜爆炸

React 项目里最让人头疼的从来不是组件写不出来，而是组件写出来之后，依赖关系像一团被猫玩过的毛线。你写了一个useEffect，本意是「只在挂载时拉一次数据」，结果 ESLint 一直提示你缺依赖；你顺手把userId加进去，页面开始无限请求；你再加个useCallback包一层，依赖链又断了一环，闭包里的值永远是旧的。

这个问题的本质是：React 的依赖数组不是「告诉 React 什么时候执行」，而是「告诉 React 这个副作用用到了哪些外部值」。一旦你把它当成执行时机的开关，就一定会踩坑。我见过太多中大型项目，一个列表页的useEffect依赖数组里塞了七八个变量，其中三个是每次渲染都新建的对象，结果请求像机关枪一样往外打。

更麻烦的是，依赖混乱往往和 API 调用配置纠缠在一起。Base URL 散落在各个axios.create里，Key 有的写在.env，有的硬编码在请求拦截器，有的藏在某个config.ts。当你想统一治理依赖时，发现连「请求到底发到哪」都说不清楚。所以这篇内容分两条线走：一条是把 React 依赖数组、闭包陷阱、useMemo/useCallback依赖链理清楚；另一条是把外部 API 调用的 Base URL 和 Key 收敛到一个统一通道，让依赖治理和配置解耦。

适合谁看？如果你正在维护一个组件超过 50 个、useEffect超过 100 处的 React 工程，或者你已经被react-hooks/exhaustive-deps的警告折磨到想关掉 ESLint，那这篇就是写给你的。下面从依赖检查清单开始，一步步落到可复制的 ESLint 配置和 TaoToken 的 settings 示例。

2. useEffect 依赖数组与闭包陷阱的排查清单

先给一份我实际项目里用的依赖检查清单，你可以直接对照自己的代码过一遍。这份清单不依赖任何工具，纯靠肉眼加 ESLint 就能覆盖 80% 的问题。

第一类：副作用里用到的所有「非稳定值」是否都在依赖数组里。非稳定值包括 props、state、context 值、组件内定义的函数、组件内定义的对象和数组。很多人漏掉的是「组件内定义的函数」，比如你在useEffect里调用了handleSuccess，而handleSuccess是在组件函数体里定义的，那它每次渲染都是新引用，必须进依赖数组，或者用useCallback包起来。

第二类：依赖数组里是否有「每次渲染都变」的值。典型的是内联对象{ id: 1 }、内联数组[1, 2]、内联函数() => {}。这些放进依赖数组等于告诉 React「每次渲染都重新执行副作用」，无限循环就是这么来的。解决办法是把它们提到组件外，或者用useMemo/useCallback稳定引用。

第三类：闭包陷阱。当你在useEffect里用了setTimeout、setInterval、事件监听，回调里引用的 state 是「创建时的快照」。如果依赖数组为空，回调永远读到初始值。正确做法是把用到的 state 放进依赖数组，或者用useRef保存最新值。我试过在轮询场景里用useRef存page，效果比每次重建定时器好很多。

第四类：useMemo和useCallback的依赖链。这两个 Hook 的依赖数组如果漏了值，返回的缓存值就是错的。更隐蔽的是「依赖链断裂」：useCallbackA 依赖了useMemoB，B 依赖了 state C，如果 C 变了但 A 的依赖数组没写 B，A 就不会更新。排查方法是顺着调用链往上找，确保每一层依赖都完整。

第五类：数据请求的依赖。useEffect里发请求，依赖数组通常应该包含请求参数。但如果你用了axios实例或请求函数，它们如果是组件内定义的，也会进依赖。这就是为什么要把请求配置抽到组件外，甚至抽到统一通道。

下面是一个典型的错误示例和修正示例，你可以对照看：

// 错误：依赖数组漏了 userId，且 fetchData 每次渲染都新建 function UserProfile({ userId }) { const [data, setData] = useState(null); const fetchData = async () => { const res = await fetch(`/api/user/${userId}`); setData(await res.json()); }; useEffect(() => { fetchData(); }, []); // ESLint 会警告缺 fetchData 和 userId return <div>{data?.name}</div>; }

// 修正：用 useCallback 稳定 fetchData，依赖补全 function UserProfile({ userId }) { const [data, setData] = useState(null); const fetchData = useCallback(async () => { const res = await fetch(`/api/user/${userId}`); setData(await res.json()); }, [userId]); useEffect(() => { fetchData(); }, [fetchData]); return <div>{data?.name}</div>; }

注意修正版里useEffect的依赖是[fetchData]，而fetchData的依赖是[userId]。这样当userId变化时，fetchData重建，useEffect重新执行，逻辑正确且没有无限循环。这就是依赖链完整的写法。

3. 可复制的 ESLint 依赖规则与 TaoToken settings 配置

光靠肉眼检查不够，得让工具帮你兜底。React 官方提供了eslint-plugin-react-hooks，核心规则就是exhaustive-deps。下面是一份可以直接复制到.eslintrc.cjs的配置，我加了几个实用调整：

// .eslintrc.cjs module.exports = { extends: [ 'eslint:recommended', 'plugin:react/recommended', 'plugin:react-hooks/recommended', ], plugins: ['react', 'react-hooks'], rules: { 'react-hooks/rules-of-hooks': 'error', 'react-hooks/exhaustive-deps': [ 'warn', { additionalHooks: '(useMyCustomHook|useDebounce|useThrottle)', enableDangerousAutofixThisMayCauseInfiniteLoops: false, }, ], 'react/jsx-uses-react': 'off', 'react/react-in-jsx-scope': 'off', }, settings: { react: { version: 'detect', }, }, };

这里有两个关键点。additionalHooks用来把你项目里自定义的 Hook 也纳入依赖检查，比如useDebounce、useThrottle，否则它们的依赖数组不会被检查。enableDangerousAutofixThisMayCauseInfiniteLoops保持false，因为自动修复依赖数组有时会引入无限循环，手动确认更安全。

配置好之后，运行npx eslint src --ext .js,.jsx,.ts,.tsx，所有依赖问题会以警告形式列出。你可以先不修，用--max-warnings 0在 CI 里卡住，逼自己逐步清理。

接下来是 API 调用配置的统一收敛。目标是把 Base URL 和 Key 从各个组件、各个axios.create里抽出来，放到一个统一的 settings 文件。这里用 TaoToken 作为统一通道，它的 API 地址是https://taotoken.net/api，你可以在控制台创建 Key，然后所有请求都走这个 Base URL。

先建一个src/config/taotoken.settings.json：

{ "baseURL": "https://taotoken.net/api", "apiKey": "sk-your-taotoken-key", "model": "claude-sonnet-4-20250514", "timeout": 30000, "headers": { "Content-Type": "application/json" } }

然后在src/config/request.ts里读取这个配置，创建统一的请求实例：

// src/config/request.ts import axios from 'axios'; import settings from './taotoken.settings.json'; export const request = axios.create({ baseURL: settings.baseURL, timeout: settings.timeout, headers: { ...settings.headers, Authorization: `Bearer ${settings.apiKey}`, }, }); request.interceptors.response.use( (response) => response.data, (error) => { if (error.response?.status === 401) { console.error('TaoToken Key 无效或过期，请检查 settings 文件'); } return Promise.reject(error); } );

这样组件里只需要import { request } from '@/config/request'，然后request.post('/v1/messages', { model: settings.model, ... })。依赖治理的角度看，请求函数不再依赖组件内的 state，useEffect的依赖数组就干净很多。

如果你用 Claude Code 或 Cline 这类工具，配置方式类似，核心三件套是 Base URL、Key、Model ID。Base URL 填https://taotoken.net/api，Key 填控制台生成的，Model ID 填你需要的模型。Cline 的 MCP 配置里也是这三项，别漏了 Model ID，否则会报模型不存在。

4. 验证依赖稳定与请求成功的具体操作

配置写完了，怎么验证依赖真的稳定、请求真的通？分三步走。

第一步，验证依赖稳定性。在useEffect里加一行日志，打印依赖数组里的值：

useEffect(() => { console.log('effect run, userId:', userId, 'fetchData:', fetchData); fetchData(); }, [fetchData, userId]);

然后在页面上触发userId变化，观察控制台。如果userId只变一次但 effect 跑了多次，说明fetchData引用不稳定，回去检查useCallback依赖。如果userId没变但 effect 反复跑，说明依赖数组里有每次渲染都变的值，通常是内联对象或函数。

第二步，验证请求成功。在request.ts里加一个测试函数：

export async function testTaoToken() { try { const res = await request.post('/v1/messages', { model: settings.model, max_tokens: 100, messages: [{ role: 'user', content: 'ping' }], }); console.log('TaoToken 请求成功:', res); return true; } catch (err) { console.error('TaoToken 请求失败:', err); return false; } }

在组件挂载时调用一次，看控制台是否打印成功。如果返回 401，检查 Key 是否复制完整；如果返回 404，检查 Base URL 是否多了或少了斜杠；如果超时，检查网络和timeout设置。

第三步，验证依赖与请求解耦。把testTaoToken从组件里移除，改成在useEffect里调用request.post，依赖数组只放请求参数。然后修改请求参数，观察是否只发一次请求。如果发了多次，说明请求函数本身进了依赖数组且不稳定，需要把它提到组件外或用useCallback包。

实测下来，这三步走完，大部分依赖和请求问题都能定位。我踩过的坑是：axios实例如果直接在组件里axios.create，每次渲染都是新实例，放进依赖数组必炸。所以统一到request.ts导出单例，是解耦的关键。

5. 常见报错排查：401、local proxy failed、reading choices、OAuth

这一节列几个高频报错和对应排查路径，都是真实遇到过的。

401 Unauthorized：最常见。先检查settings.json里的apiKey是否完整，有没有多余空格。然后检查Authorization头格式是不是Bearer sk-xxx。如果 Key 是从控制台复制的，确认没有复制到换行符。TaoToken 的 Key 在控制台的 API Keys 页面生成，生成后只显示一次，丢了就重新生成。

local proxy failed：这个报错通常出现在本地开发环境，请求被本地代理拦截。检查package.json里的proxy字段，或者vite.config.ts里的server.proxy。如果你把 Base URL 设成了相对路径/api，但本地没有配代理，就会失败。解决办法是直接用完整 Base URLhttps://taotoken.net/api，或者在代理配置里把/api转发到https://taotoken.net。

reading choices：这个报错说明请求发出去了，但响应结构不符合预期。通常是 Model ID 写错了，或者请求体格式不对。检查settings.json里的model字段，确认是 TaoToken 支持的模型 ID。然后检查请求体是否有messages数组，max_tokens是否设置。如果用的是 Claude Code 或 Cline，检查它们的配置文件里 Model ID 是否和 settings 一致。

OAuth 相关报错：如果你用 Claude Code 的 OAuth 登录方式，但想切换到 TaoToken 的 Key 方式，需要在配置文件里把认证方式改成 API Key。Claude Code 的配置文件通常在~/.claude/settings.json或项目根目录的.claude/settings.json，把apiKey字段填上 TaoToken 的 Key，Base URL 填https://taotoken.net/api。如果还报 OAuth 错误，检查是否有残留的 OAuth token 缓存，清掉再试。

Codex auth.json 配置：如果你用 Codex 类工具，认证文件是auth.json。里面需要填apiKey、baseURL、model三项。baseURL填https://taotoken.net/api，apiKey填 TaoToken 的 Key，model填模型 ID。三件套缺一不可，少一个就会报认证失败或模型不存在。

排查顺序建议：先看 HTTP 状态码，401 查 Key，404 查 URL，429 查额度，500 查请求体。然后看控制台完整错误信息，定位是网络层还是应用层。最后对照 settings 文件逐项检查，确保 Base URL、Key、Model ID 三项一致。

6. 把依赖治理和 Key 通道固定成工程习惯

依赖治理不是一次性任务，而是每次写useEffect时的肌肉记忆。我的做法是：新建组件时先写依赖数组，再写副作用体；useCallback和useMemo只在确实需要稳定引用时才用，不滥用；请求配置一律从request.ts导入，不在组件里直接axios。

Key 通道的统一也是同理。把 Base URL 和 Key 收敛到taotoken.settings.json，所有请求走同一个实例，好处是换 Key 只改一个文件，排查 401 只查一个地方。如果你还在多个文件里散落 Key，建议这周就抽出来。

最后给一个实用技巧：在 CI 里加一条eslint --max-warnings 0，把依赖警告当成错误卡住。刚开始会很痛苦，但两周后你会发现useEffect的 bug 少了一大半。请求配置那边，加一个启动时的testTaoToken自检，开发环境跑一次，确认 Key 和 Base URL 没问题再进业务逻辑。这样依赖和配置两条线都稳了，深夜爆炸的概率就低很多。