常见问题解答

配置相关问题

1. 如何获取 Authorization 配置？

登录网页版 Apifox
按 F12 打开开发者工具
在 Network 面板中选择任意请求
查看 Headers 选项卡，找到 Authorization 字段并复制其值

2. 为什么获取不到项目列表？

检查 Authorization 配置是否正确
确认网络连接正常
验证 Apifox 账户是否有项目访问权限

3. 如何配置多个项目？

目前插件支持单项目配置，多项目支持将在后续版本中实现。

代码生成问题

1. 生成的代码格式不正确怎么办？

检查项目是否安装了 qs 依赖
确认 Prettier 配置是否正确
查看输出日志了解具体错误信息

2. 为什么接口函数没有生成？

确认接口详情是否完整
检查生成路径是否有写入权限
验证项目配置是否正确

3. 如何更新已存在的接口代码？

插件支持智能更新机制：

会保留文件中非自动生成的内容
只更新变更的接口方法和类型定义
自动处理代码合并和冲突解决

模型支持问题

1. Axios 模型支持哪些配置？

自定义 Axios 实例引用路径
配置返回数据字段
支持请求拦截器和响应拦截器

2. 微信小程序模型需要什么依赖？

需要 qs 库处理查询参数
自动生成的请求封装文件包含所有必要代码
支持微信小程序的所有请求方法

3. 自定义模型如何配置？

需要提供返回字符串的函数
函数接收包含接口信息的 options 参数
支持自定义返回函数和拓展函数

性能问题

1. 代码生成速度慢怎么办？

检查网络连接速度
确认项目大小和接口数量
查看是否有其他程序占用大量系统资源

2. 插件占用内存过大怎么办？

重启 VSCode 释放内存
检查是否有其他插件冲突
更新插件到最新版本

兼容性问题

1. 支持哪些版本的 VSCode？

插件支持 VSCode 1.74.0 及以上版本。

2. 支持哪些操作系统？

插件支持 Windows、macOS 和 Linux 操作系统。

3. 支持哪些编程语言？

主要支持 TypeScript 和 JavaScript 项目。

故障排除

1. 插件无法启动怎么办？

检查 VSCode 版本是否符合要求
重新安装插件
查看 VSCode 开发者工具中的错误信息

2. 生成的代码有语法错误怎么办？

检查插件版本是否为最新
确认项目 TypeScript 配置是否正确
提交 issue 反馈问题

3. 如何查看详细日志？

在 VSCode 中打开输出面板
选择 "AutoAPIGen" 查看日志信息
根据日志内容定位问题

其他问题

1. 如何反馈问题和建议？

在 GitHub 仓库提交 issue
通过插件市场联系开发者
加入用户交流群反馈问题

2. 插件会收集用户数据吗？

插件不会收集任何用户隐私数据，所有配置信息都保存在本地。

3. 如何参与插件开发？

在 GitHub 仓库查看源代码
提交 Pull Request 贡献代码
参与社区讨论和功能规划