VSCode如何连接AWS云服务器进行远程代码修改

VSCode连接AWS EC2关键在三要素：IdentityFile权限须为600（Windows需禁用继承并仅保留当前用户完全控制）、User须匹配系统默认（Amazon Linux用ec2-user，Ubuntu用ubuntu）、HostName必须为当前EC2控制台显示的公网IPv4地址，任一错误均导致Permission denied或超时。

VSCode 连接 AWS EC2 实例做远程代码修改，关键不在“能不能连”，而在于 IdentityFile 权限是否合规、User 是否匹配系统默认用户、以及 HostName 是否用了当前有效的公网 IP —— 三者任一出错，都会卡在连接阶段，根本进不了编辑环节。

为什么 ssh 连接总是 Permission denied (publickey)？

这是最常卡住的一步，不是密码错了，而是密钥文件本身被系统拒绝加载：

• IdentityFile 路径必须写绝对路径（Windows 用 C:\Users\name\.ssh\my-key.pem，Linux/macOS 用 /home/name/.ssh/my-key.pem）
• Windows 下 .pem 文件权限必须收紧：右键 → 属性 → 安全 → 高级 → 禁用继承 → 转换为显式权限 → 只保留当前用户“完全控制”
• Linux/macOS 下执行 chmod 600 ~/.ssh/my-key.pem，否则 OpenSSH 直接忽略该密钥
• AWS 启动实例后分配的公网 IP 是动态的，每次重启可能变化，HostName 必须填当前控制台显示的 IPv4 地址，不能复用旧配置

Remote-SSH 配置里 User 和 HostName 怎么填才不踩坑？

填错 User 会导致连接成功但立即断开，或提示 “no shell”；HostName 写错则直接超时：

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• Amazon Linux 2/2023 默认用户是 ec2-user，不是 root 或 admin
• Ubuntu 系统（如 AWS Marketplace 的 Ubuntu Server）默认用户是 ubuntu
• HostName 不要写私有 IP（如 172.31.x.x），必须是 EC2 控制台“IPv4 Public IP”那一栏的地址
• 如果启用了自定义 SSH 端口（非 22），务必在配置中加 Port 2222 行，否则插件默认只试 22

连接成功后，打开文件夹却反复要输密码？

这不是认证问题，而是 VSCode 在用 SFTP 模式回传文件树时触发了二次认证 —— 实际上它本不该发生：

• 确保你没同时装 SFTP 插件（如 Natizyskunk.sftp），它会和 Remote-SSH 冲突，强制走密码验证
• 连接后不要点“Open Folder”再手动输密码；应该直接在远程资源管理器里右键主机 → “Connect to Host in New Window”，然后在新窗口里点“File → Open Folder”，路径填 /home/ec2-user 或 /home/ubuntu，这时不会弹密码框
• 如果仍弹窗，检查 ~/.ssh/config 里有没有漏掉 StrictHostKeyChecking no，首次连接时缺少这行会卡在 host key 验证

远程终端能跑命令，但 Python/Node 插件不生效？

Remote-SSH 连接后，所有扩展默认只在本地运行。编辑器看起来在远程，但语言服务、调试器、格式化工具其实还在你本机找环境：

• 必须在远程窗口的 Extensions 面板（左侧第四个图标）里，切换到“Show Installed Extensions on SSH:xxx”标签页
• 搜索并安装 Python（ms-python.python）、Prettier（esbenp.prettier-vscode）等插件 —— 它们会部署到远程服务器的 ~/.vscode-server/extensions/ 下
• 远程 Python 解释器路径需手动指定：Ctrl+Shift+P → “Python: Select Interpreter” → 浏览到 /usr/bin/python3 或 /home/ec2-user/.pyenv/shims/python
• 别依赖本地的 settings.json；远程项目的 .vscode/settings.json 才真正生效

最易被忽略的一点：AWS 安全组必须放行 TCP 22 端口，且源 IP 要允许你的本地出口 IP（或者设为 0.0.0.0/0 仅测试用）。很多人配对了密钥、填对了用户，却忘了在 EC2 控制台的安全组里开 22 端口，结果看到的永远是“connection timed out”。