VS Code 官方文档说明，安装 VS Code Server 时，本机需要通过 HTTPS 443 端口访问 2 个更新地址。所以，VS Code 连接远程 Mac 总要密码时，本周不要先重装扩展，也不要反复改 Mac 账号：先在 Windows 终端用同一组用户名、主机地址和端口验证普通 SSH；认证成功后，再按日志区分密钥问题与服务器安装问题。(code.visualstudio.com)

本周建议动作：

  • 先完成一次普通 ssh 登录，并记录实际使用的用户名、地址和端口。
  • 再从 Visual Studio Code 的 Remote - SSH 输出窗口确认密码提示处于哪个阶段。
  • 如果已经认证成功，却卡在“正在安装服务器”，停止重输密码，转查下载网络与远端服务。
01

谁适合按这份排障顺序操作？

这篇文章适合只有 Windows 电脑、需要用 VS Code 在远程 Mac 上完成 Python、前端或 iOS 课程的学生。

如果普通 SSH 可以登录，但 VS Code 仍反复询问密码、密钥口令，或者重连时卡在服务器安装，这份流程可以直接照着做。

如果连普通 SSH 都失败，应先处理账号、地址、端口或远程登录权限，而不是从 VS Code 扩展开始猜。

02

先看密码框出现在哪一段：三种故障不要混查

同样是“又弹出密码框”，背后的问题可能完全不同。我们先把连接过程拆成三段：

  1. 基础 SSH 认证阶段：Windows 终端还没有登录远程 Mac。
  2. 重复认证阶段：终端已经登录过，但 VS Code 建立另一条会话时再次要求密码或密钥口令。
  3. 服务器准备阶段：账号已经通过认证，VS Code 开始安装或启动 VS Code Server，却在中途重新开始。

第一种要查连接信息。第二种要查认证方式。第三种则要查日志、下载和传输。

Remote - SSH 支持密码登录，但官方明确说明，密码和其他替代认证令牌不会被扩展保存；官方同时建议长期使用时优先采用密钥认证。也就是说，重新建立会话时再次输入密码，可能是设计行为，不等于密码错误。(code.visualstudio.com)

先记录三个可见结果

在 Windows PowerShell 或命令提示符中，使用与 VS Code 完全相同的连接信息：

ssh 用户名@主机地址

如果服务方提供了非默认端口，则使用：

ssh -p 端口 用户名@主机地址

重点不是命令长短，而是三项必须一致：

  • 用户名是否相同；
  • 主机地址是否相同；
  • 端口是否相同。

正常结果通常是：首次连接可能出现主机指纹确认，随后要求密码或密钥口令，成功后进入远程 Mac 的命令行。macOS 的官方说明也把远程登录定义为通过 SSH 或 SFTP 访问 Mac，并使用 ssh username@hostname 连接。(support.apple.com)

如果这里已经失败，按下面顺序检查：

  • Permission denied：优先核对用户名、密码或远端公钥。
  • Connection timed out：检查地址、端口、网络和学校设备策略。
  • Connection refused：可能是远程登录服务未启用，或该端口没有 SSH 服务。
  • 主机指纹变化提示：先向环境提供方确认主机是否更换，不要直接删除校验记录。

不要用关闭主机指纹校验、公开远程端口或共享账号来“修复”。主机指纹相当于门口登记的设备特征；突然变化时，先确认是不是换了机器，而不是把登记制度拆掉。

03

第一步：让 VS Code 复用已经验证过的连接

普通 SSH 能登录，不代表 VS Code 一定使用了同一个配置。常见差异包括：VS Code 选了另一个 SSH 配置文件、连接别名指向旧地址，或者没有读到指定私钥。

在 VS Code 中打开命令面板，执行 Remote-SSH: Connect to Host...，选择的主机应与终端测试使用同一个别名。官方连接流程也要求先在终端验证 SSH，再在 VS Code 中使用同一个 user@hostname。(code.visualstudio.com)

如果想固定连接参数，可以在 Windows 用户目录下的 SSH 配置文件中写入类似内容：

Host remote-mac-study
    HostName example-host
    User student
    Port 22
    IdentityFile ~/.ssh/id_ed25519

这里的 IdentityFile 只指向本机私钥路径。不要把私钥内容粘贴进 VS Code 设置、聊天窗口、课程群或代码仓库。

官方文档给出的配置思路也是用 Host、User、HostName 和 IdentityFile 固定连接身份；之后 Remote - SSH 会从主机列表中调用这条配置。(code.visualstudio.com)

查看提示来自密码，还是来自密钥口令

密码和密钥口令不是一回事：

  • 密码：远程 Mac 账号的登录密码。
  • 私钥口令：保护本机私钥文件的口令。
  • 双重验证令牌：由环境提供方额外要求输入的验证码或令牌。

可以在终端中运行更详细的连接测试：

ssh -v remote-mac-study

观察输出中是否出现：

  • 正在尝试某个私钥；
  • 私钥被拒绝；
  • 已完成 publickey 认证；
  • 又回到密码认证；
  • 已登录后才开始执行远程命令。

如果终端显示已经完成公钥认证，VS Code 仍要求输入密码，优先检查 VS Code 使用的配置文件和主机别名。不要因为看到密码框，就立刻重新生成远端账号。

04

第二步：密钥不自动登录时，按“钥匙链”排查

可以把 SSH 密钥想成一套门禁系统：

  • 公钥像登记在门禁系统里的样本，可以放到远端；
  • 私钥像真正的钥匙，只能留在 Windows 电脑；
  • ssh-agent像钥匙保管处，帮助 SSH 客户端调用私钥；
  • 密钥口令则是钥匙盒的保护锁。

微软的 OpenSSH 文档明确指出，私钥应像密码一样保护；公钥可以部署到服务器，私钥不能公开。ssh-agent 可以在 Windows 安全上下文中保存私钥，供 SSH 客户端使用。(learn.microsoft.com)

按这个顺序检查：

1．确认私钥在本机

Get-ChildItem $env:USERPROFILE\.ssh

常见私钥文件没有 .pub 后缀，公钥文件通常带 .pub。如果只有公钥，没有对应私钥，远程端无法完成公钥认证。

2．确认配置指向正确文件

ssh -G remote-mac-study | Select-String "user|hostname|port|identityfile"

如果输出的用户名、地址、端口或 identityfile 与预期不符，先修 SSH 配置，再回到 VS Code。

3．确认 ssh-agent 状态

Get-Service ssh-agent

如果服务没有运行，可以在获得本机管理员许可的前提下启动它：

Start-Service ssh-agent
ssh-add $env:USERPROFILE\.ssh\id_ed25519

随后检查已载入的密钥：

ssh-add -l

学校电脑可能禁止启动服务，或者设备管理策略会阻止修改服务状态。遇到这种情况，不要绕过管理策略。可以继续使用受控的密码登录，或向学校管理员申请允许的 SSH 使用方式。

4．确认远端公钥匹配

本机的公钥必须与远端账号登记的公钥成对。若私钥换过、远端账号重置过，旧公钥可能已经失效。此时需要让环境提供方核对远端授权文件，不要把私钥发送给对方。

05

认证成功后还在安装服务器：这已经不是同一个问题

Remote - SSH 认证成功后，还要在远程主机准备 VS Code Server。官方文档说明，默认情况下，扩展会尝试在远端下载服务器组件；如果远端下载失败，可能回退到本地下载后再传输到远端。(code.visualstudio.com)

因此，出现“正在安装服务器”时，重点检查以下三层：

远端下载能力

远程 Mac 是否能够访问所需下载地址？如果托管环境限制出站网络，远程端可能无法直接取得服务器组件。

Windows 本机出站网络

官方列出的本机 HTTPS 依赖包括 update.code.visualstudio.com 和 vscode.download.prss.microsoft.com，使用的是 443 端口。学校网络、代理或安全软件可能阻断其中一项。(code.visualstudio.com)

本地传输回退

如果远端不能下载，VS Code 可能改为本地下载再传输。此时 SSH 认证已经完成，但传输过程仍可能因代理、权限、磁盘空间或远端目录限制失败。

在 VS Code 中打开命令面板，执行 Remote-SSH: Show Log，重点看最后一个阶段：

  • 如果日志停在认证前，回到用户名、地址、端口和密钥；
  • 如果日志显示认证成功后开始下载，查网络和代理；
  • 如果日志显示已传输但启动失败，查远端目录、旧服务和权限；
  • 如果扩展安装后才失败，区分扩展问题，不要继续重置 SSH。

官方排障文档建议通过 Remote-SSH: Show Log 获取日志，并先确认外部终端能否独立 SSH 登录。(code.visualstudio.com)

什么时候可以删除 VS Code Server？

如果日志明确显示远端服务器组件启动失败，可以使用命令面板中的 Remote-SSH: Kill VS Code Server on Host 清理远端组件，再重新连接。该动作针对的是 VS Code Server，不是 Mac 账号，也不会替代 SSH 密钥配置。官方排障文档把它列为处理服务器启动错误的方式之一。(code.visualstudio.com)

如果只是每次输入密码，不要为了“让密码消失”而删除服务器。两者属于不同阶段。

06

独立 FAQ：四个新手容易混淆的判断

这些问题的共同点是：终端、VS Code 和远程服务器并不是同一层。排障时必须先确认失败发生在哪里。

07

修复后，用一次完整重连确认结果

不要只看密码框是否暂时消失。我们建议完成下面的验收流程：

  • ✅ 关闭 VS Code 的远程窗口；
  • ✅ 重新打开 VS Code，使用同一个 Remote - SSH 主机；
  • ✅ 观察是否仍要求密码或密钥口令；
  • ✅ 打开远程 Mac 上实际的项目目录；
  • ✅ 在 VS Code 终端运行一条无破坏性的命令，例如查看当前目录；
  • ✅ 新建一个测试文件，保存后重新打开；
  • ✅ 关闭连接，再次连接并确认文件仍在原位置。

验收时，至少记录四个结果：

  1. 普通 SSH 是否成功；
  2. VS Code 是否完成认证；
  3. VS Code Server 是否完成启动；
  4. 项目目录和文件是否可读写。

如果只有第 1 项成功，继续查 VS Code 配置。如果第 1、2 项成功，但第 3 项失败，转查服务器安装和网络。如果四项都成功，却每次重连仍要密码，那通常是密码未保存的正常行为，应考虑密钥认证，而不是继续重装。

08

三种方案怎么选：密码、密钥，还是更换环境？

方案 适合情况 优点 代价与限制 判断动作
继续使用密码 偶尔连接、学校电脑受限、无法管理 ssh-agent 设置少，立即可用 重连可能再次输入；密码不能由 Remote - SSH 保存 普通 SSH 稳定且课程使用频率不高时保留
配置 SSH 密钥 每天学习、频繁重连、有独立 Windows 账户 减少重复输入，连接更稳定 需要保护私钥，远端必须登记匹配公钥 先完成终端密钥登录，再让 VS Code 使用同一配置
更换远程环境 主机没有稳定 SSH、账号权限混乱、目录不可控 减少反复排查，便于保存课程项目 需要重新迁移项目和配置工具 连续出现认证、目录和服务器安装多层问题时评估

如果只是临时完成一两次课程实验，密码登录并不一定需要改造。若每周都要使用，且 Windows 电脑允许运行 ssh-agent，授权配置密钥更省事。

如果正在寻找具备独立账号、稳定 SSH 和可控项目目录的远程 Mac，可以先查看 MESHLAUNCH 的远程 Mac 环境说明，再对照课程要求核对连接方式。选择前应确认是否支持所需的 SSH、root 权限、项目保存位置和软件安装权限，而不是只看能否打开桌面。

09

最后一个决策：继续修当前主机，还是换成可控的 Mac 环境？

当前主机如果只是偶尔多问一次密码，缺点主要是操作麻烦，不必急着更换。但如果它同时存在 SSH 不稳定、多人共用账号、项目目录不可控或无法安装 VS Code Server，继续重装扩展通常不会改变结果；这些是环境能力问题，不是输入次数问题。

对于需要连续完成课程作业的学生，更可控的远程 Mac 往往更省排障时间。若课程只需要临时使用 macOS、Python、前端工具或 Xcode，可以把 MESHLAUNCH 的 Mac 租赁方案与自购 Mac、本地 Windows 加虚拟机分别比较：短期测试适合租赁，长期高强度使用或必须连接物理设备时，自购设备可能更合适。

完成选择后，把连接方式、账号权限、项目保存目录和重连步骤写成一张小清单。下一次遇到密码框时，先判断它属于认证阶段，还是已经进入 VS Code Server 阶段；这个判断比继续输入密码更重要。