单独运行supabase link报错，求详解--project-ref参数含义与用法

问题场景 #

按照Supabase Next.js入门指南执行supabase link命令时，出现以下报错：

required flag(s) "project-ref" not set
Try rerunning the command with --debug to troubleshoot the error.

关于--project-ref #

--project-ref是Supabase CLI v1及以上版本中supabase link命令的必填参数，对应你在Supabase控制台创建的项目的唯一引用标识。这个标识可以在Supabase项目的设置页面获取，通常是项目URL末尾的一串随机字符串（例如abc123xyz789）。

正确使用方式 #

执行supabase link时必须指定该参数，命令格式如下：

supabase link --project-ref <你的项目引用标识>

输入命令后，CLI会要求你输入项目的数据库密码（可在Supabase控制台的数据库设置中找到），验证通过后即可完成本地项目与远程Supabase项目的关联，之后就能正常执行supabase db pull同步数据库结构。

额外说明 #

当前官方的Next.js入门指南未提及这个必填参数，导致用户执行命令时受阻，建议官方更新文档补充该关键细节。

内容的提问来源于stack exchange，提问作者dutch