VSCode无成熟CouchDB插件，需用REST Client扩展发HTTP请求；必须带Authorization头、正确处理_rev字段和URL编码，且确保CouchDB监听0.0.0.0并配置_users权限。
VSCode 本身不内置 CouchDB 支持，必须靠插件 + 手动 HTTP 请求完成管理；直接装个“CouchDB”名字的扩展大概率是过时或不维护的，别信。
为什么不能用官方或热门 CouchDB 插件
目前（2026 年 4 月）VSCode 市场中没有成熟、持续维护的 CouchDB 专用 GUI 管理插件。所谓“CouchDB Explorer”“CouchDB Tools”等扩展，要么仅支持旧版 CouchDB 2.x，要么无法处理 3.x 的认证机制（如 _session 登录流程），要么根本无法列出数据库或返回空响应。
真正可行的路径只有一条：把 VSCode 当作一个带 REST 客户端能力的编辑器，配合 curl、httpie 或内置的 REST Client 扩展来发请求。
常见错误现象：
- 插件连接成功但
GET /_all_dbs返回401 Unauthorized—— 实际是插件没传Cookie或Authorization头 - 点击“刷新数据库列表”后界面卡住或报
TypeError: Cannot read property 'map' of undefined—— 插件解析响应结构失败，因 CouchDB 3.x 默认返回 JSON 包裹体（{"rows": [...]}），而非裸数组 - 插件声称支持文档编辑，但保存后服务器无变化 —— 它没带上
_rev字段，CouchDB 拒绝无修订号的 PUT
用 REST Client 扩展发请求是最稳的方式
安装官方推荐的 humao.rest-client 插件（截至 2026 年仍活跃更新），它支持在 .http 文件里写类 cURL 的请求语句，自动处理 Cookie、重定向、JSON 格式化。
实操建议：
- 新建一个
couchdb.http文件，粘贴以下内容（按需替换localhost:5984和凭据）：
### 获取所有数据库
GET http://localhost:5984/_all_dbs
Authorization: Basic YWRtaW46cGFzc3dvcmQ=
<h3>创建新数据库</h3><p>PUT <a href="https://www.php.cn/link/9f0e75318f99d12a92fb1f4ba3507b7b">https://www.php.cn/link/9f0e75318f99d12a92fb1f4ba3507b7b</a>
Authorization: Basic YWRtaW46cGFzc3dvcmQ=</p><h3>添加一个文档（注意：必须含 _id）</h3><p>POST <a href="https://www.php.cn/link/9f0e75318f99d12a92fb1f4ba3507b7b">https://www.php.cn/link/9f0e75318f99d12a92fb1f4ba3507b7b</a>
Content-Type: application/json
Authorization: Basic YWRtaW46cGFzc3dvcmQ=</p><p>{
"_id": "user-1001",
"name": "Alice",
"email": "alice@example.com",
"type": "account"
}</p><h3>查询该文档</h3><p>GET <a href="https://www.php.cn/link/9f0e75318f99d12a92fb1f4ba3507b7b/user-1001">https://www.php.cn/link/9f0e75318f99d12a92fb1f4ba3507b7b/user-1001</a>
Authorization: Basic YWRtaW46cGFzc3dvcmQ=-
Authorization: Basic是 Base64 编码的username:password，不是明文；可提前用echo -n 'admin:password' | base64生成 - 所有写操作（
PUT/POST/DELETE）必须带Authorization头；CouchDB 3.x 默认启用 admin party 关闭，不认证就拒绝 - 更新文档时，务必先
GET出原数据，保留_rev字段，再在请求体中带上它，否则会报409 Conflict
CouchDB 的 _design 文档和视图怎么调用
视图查询不是直连集合，而是通过 GET /{db}/_design/{ddoc}/_view/{viewname} 发起，且需注意路径编码和参数拼接规则。
例如，你已创建了设计文档 _design/users，其中定义了视图 by_email，想查邮箱含 @example.com 的记录：
- 不能写成
GET /accounts/_design/users/_view/by_email?q=@example.com——q不是合法参数 - 正确方式是用
key或startkey/endkey，且字符串 key 必须 JSON 编码：
### 查询 email 等于 "alice@example.com" GET https://www.php.cn/link/9f0e75318f99d12a92fb1f4ba3507b7b/_design/users/_view/by_email?key="alice%40example.com" Authorization: Basic YWRtaW46cGFzc3dvcmQ=
注意：%40 是 @ 的 URL 编码；如果 key 是复合结构（如数组），要先 JSON.stringify 再 encodeURI，否则 CouchDB 解析失败，返回空 rows。
另外，_design 文档本身也是普通文档，可用 PUT 直接上传，但必须确保 _id 以 _design/ 开头，且内容含 views 字段 —— 少一个冒号或缩进错位，整个视图就不可用。
本地开发时容易漏掉的权限和配置项
CouchDB 启动后默认只监听 127.0.0.1，VSCode 在远程 SSH 连接下无法访问；同时，若用 Docker 运行，未暴露 5984 端口或未挂载 local.ini，也会导致连接超时或认证失败。
关键检查点：
- 确认
curl -I http://localhost:5984/能返回200 OK和Server: CouchDB/3.3.3 - 检查
etc/local.ini中是否有bind_address = 0.0.0.0（非仅127.0.0.1） - 若启用了 HTTPS，VSCode 的 REST Client 默认不校验证书，需加
# @no-ssl-warning注释行，或改用http://+ 反向代理 - Windows 用户注意：PowerShell 对双引号和反斜杠转义更敏感，
.http文件建议用 VSCode 内置终端执行，别复制到 CMD
最常被忽略的一点：CouchDB 的 _users 数据库默认不可读，即使你是 admin，也得显式设置 "members": {"names": ["admin"], "roles": ["_admin"]} 才能查用户列表 —— 很多调试卡在这一步，却以为是插件问题。
