在正式开课之前需要在本地搭建好开发测试环境，这是一切的基础！
一、如何在本地运行代码
要在本地运行代码，您需要安装某个版本的 Python。
然后使用代码库，您需要克隆它：
git clone https://github.com/microsoft/generative-ai-for-beginners cd generative-ai-for-beginners一旦完成所有操作，您就可以开始了！
二、安装 及配置Miniconda
Miniconda 是一个轻量级安装程序，用于安装 Conda、Python 以及一些包。 Conda 本身是一个包管理器，可以轻松设置和切换不同的 Python虚拟环境和包。它还非常适合安装无法通过pip获取的包。
您可以按照 MiniConda 安装指南进行设置。
配置conda和pip国内镜像源
①、pip镜像
pip国内源设为默认，做法是：
（友情提示：建议大家粘贴为文字后检查一下网址！！！粘贴为文字后检查一下网址！！！粘贴为文字后检查一下网址！！！）
清华pip镜像
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple临时使用
另外如果临时使用可以使用
使用pip的时候在后面加上-i参数，指定pip源：
pip install xxx -i https://pypi.tuna.tsinghua.edu.cn/simple替换“xxx”为你需要安装的模块名称。
②、conda镜像
清华conda镜像
注：由于更新过快难以同步，我们不同步pytorch-nightly,pytorch-nightly-cpu,ignite-nightly这三个包。
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/ conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/ conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/pytorch/ conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/pytorch/linux-64/ conda config --set show_channel_urls yesMiniconda 是一个 Anaconda 的轻量级替代，默认只包含了 python 和 conda，但是可以通过 pip 和 conda 来安装所需要的包。
Miniconda 安装包可以到 https://mirrors.tuna.tsinghua.edu.cn/anaconda/miniconda/ 下载。
channels: - defaults show_channel_urls: true default_channels: - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/r - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/msys2 custom_channels: conda-forge: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud msys2: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud bioconda: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud menpo: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud pytorch: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud pytorch-lts: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud simpleitk: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud deepmodeling: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/接下来conda的操作可以参考：
#获取版本号conda --version 或 conda -V#检查更新当前condaconda update conda#查看当前存在哪些虚拟环境condaenvlist 或 conda info -e#Create env#Create env with python 3.7 and pipconda create --name whatwhalepython=3.7pip#Activate env#Activate by nameconda activate whatwhale#Deactivate envconda deactivate#Removing an environment#Remove environment by name# remove env#conda env remove --name whatwhale# verifycondaenvlist#查看--安装--更新--删除包conda list： conda search package_name# 查询包condainstallpackage_name condainstallpackage_name=1.5.0 conda update package_name conda remove package_name查看当前源
使用当前代码即可查看当前的源是哪一个。
conda config --show channels三、安装vscode并配置远程连接SSH服务器
在日常开发 / 运维工作中，VSCode 凭借强大的插件生态和可视化编辑能力，成为远程操作服务器的首选工具。本文将手把手教你通过 VSCode 连接 SSH 服务器，涵盖插件安装、多方式配置连接、密码 / 密钥登录、图标缺失兜底方案全流程，新手也能轻松上手！
①、前置条件
在开始前，请确认满足以下条件：
| 环境 / 设备 | 要求说明 |
|---|---|
| 本地机器 | 安装最新版 VSCode（下载地址），支持 Windows/macOS/Linux 系统 |
| 远程服务器 | 1. 开启 SSH 服务（默认端口 22，若修改需记录新端口）；2. 服务器 IP 可正常访问（示例用 211.71.149.62，替换为你的真实 IP）；3. 拥有服务器登录用户名 + 密码 / 私钥 |
| 网络 | 本地与服务器网络互通（可 ping 通服务器 IP，或确认 22 端口开放） |
②、步骤 1：安装 Remote - SSH 插件
VSCode 本身不自带 SSH 连接功能，需安装官方核心插件：
打开 VSCode，点击左侧边栏的「扩展」图标（快捷键 Ctrl+Shift+X/Cmd+Shift+X）；
在扩展搜索框中输入 Remote - SSH，找到微软官方发布的「Remote - SSH」插件（作者：Microsoft，标识为「远程服务器 + SSH」样式）；
点击「安装」按钮，安装完成后无需重启（若后续图标不显示再重启）。
注意：需确保安装的是微软官方版本，避免第三方仿冒插件导致功能异常。
③、步骤 2：SSH 连接入口（解决「远程资源管理器」图标缺失问题）
很多用户安装插件后找不到「远程资源管理器」图标，以下提供 3 种兜底入口，任选其一即可：
入口 1：欢迎页「Connect to…」（最直接，推荐）
若 VSCode 打开后显示欢迎页（如截图所示），直接点击「Start」区域下的 「Connect to…」（位于「Clone Git Repository…」下方），即可进入 SSH 连接配置流程。
入口 2：命令面板（万能兜底）
无论是否显示图标，按快捷键 Ctrl+Shift+P（macOS 为 Cmd+Shift+P）打开命令面板，输入 Remote-SSH: Connect to Host…，回车后直接进入连接配置。
入口 3：远程资源管理器图标（若显示）
若安装插件并重启后，左侧边栏出现「远程资源管理器」图标（样式为「><」左右箭头），点击该图标即可打开 SSH 目标面板；若未显示，无需纠结，直接用入口 1/2 即可。
④、步骤 3：配置 SSH 连接信息
方式 1：可视化配置（新手推荐）
1、通过上述任意入口进入「SSH 连接配置」后，选择「Add New SSH Host…」；
2、弹出输入框，输入 SSH 连接基础命令，格式如下：
ssh用户名@服务器IP -p 端口号示例（默认 22 端口）：ssh root@211.71.149.62
示例（自定义端口，如 2222）：ssh root@211.71.149.62 -p 2222
3、按回车后，VSCode 会提示「选择要保存配置的文件」，选择默认的 config 文件（Windows 路径：C:\Users\你的用户名.ssh\config；macOS/Linux 路径：~/.ssh/config），点击保存。
方式 2：手动编辑 SSH Config 文件（进阶，支持更多配置）
若需自定义别名、密钥登录、防超时等，手动编辑配置文件更灵活：
1、打开命令面板（Ctrl+Shift+P），输入 Remote-SSH: Open SSH Configuration File…，选择默认的 config 文件；
2、在打开的 config 文件中，粘贴以下模板并修改参数：
ServerAliveInterval60# 自定义连接别名（如 server-211，方便识别）Host server-211 HostName211.71.149.62# 服务器真实 IPUser root# 登录用户名（如 root、admin）Port22# SSH 端口，默认 22，修改后同步此处# 可选：密钥登录（替换为本地私钥路径，注释取消即可生效）# IdentityFile C:\Users\你的用户名\.ssh\id_rsa # Windows 私钥路径# IdentityFile ~/.ssh/id_rsa # macOS/Linux 私钥路径# 可选：防止连接超时（每60秒发心跳包）ServerAliveInterval603、保存 config 文件，VSCode 会自动加载新配置。
⑤、步骤 4：连接 SSH 服务器
方式 1：密码登录（最基础）
1、通过「Connect to…」/ 命令面板进入「SSH Target」列表，找到你配置的服务器（如 server-211 或 root@211.71.149.62）；
2、点击服务器名称旁的「连接」图标，或右键选择「在新窗口中连接」/「在当前窗口中连接」；
3、首次连接时，VSCode 会弹出「选择平台」提示（根据服务器系统选择，如 Linux）；
4、随后弹出输入框，输入服务器登录密码（输入时无字符显示，属于正常安全机制），按回车；
5、等待 3-5 秒，若 VSCode 左下角状态栏显示「SSH: 服务器 IP / 别名」，说明连接成功！
方式 2：密钥登录（免密码，更安全）
密钥登录可避免频繁输入密码，且安全性更高，步骤如下：
1、本地生成密钥对（若已有则跳过）：打开 VSCode 终端（快捷键 Ctrl+），执行以下命令：
ssh-keygen -t rsa -b4096按回车默认保存路径（Windows：C:\Users\你的用户名.ssh\id_rsa；macOS/Linux：~/.ssh/id_rsa），无需设置密钥密码（或按需设置）。
2、将公钥上传到服务器：
（1）方法 1（推荐）：终端执行以下命令（替换用户名和 IP），自动复制公钥到服务器：
ssh-copy-id root@211.71.149.62（2）方法 2（手动）：若 ssh-copy-id 不可用，打开本地 id_rsa.pub 文件（公钥），复制全部内容；登录服务器，将内容粘贴到 /root/.ssh/authorized_keys 文件（无该文件则新建），并执行 chmod 600 /root/.ssh/authorized_keys 确保权限。
3、VSCode 启用密钥登录：回到 config 文件，取消 IdentityFile 行的注释，填写本地私钥路径，保存后重新连接服务器，即可免密码登录。
⑥、连接成功后的常用操作
1、打开服务器文件夹：点击左侧「资源管理器」→「打开文件夹」，选择服务器上的目录（如 /usr/local），可可视化编辑文件；
2、打开远程终端：快捷键 Ctrl+（反引号），或点击「终端」→「新建终端」，直接执行服务器命令（如 FIO 测试、文件操作）；
3、安装服务器端插件：连接成功后安装的插件会自动部署到服务器（如 Python、Docker、语法高亮插件），无需重复配置；
4、断开连接：点击左下角「SSH: 服务器 IP / 别名」→「关闭远程连接」，或直接关闭 VSCode 窗口。
⑦、常见问题与解决
问题 1：「远程资源管理器」图标始终不显示
原因：VSCode 插件加载缓存问题；
解决：无需纠结图标，直接用「欢迎页 Connect to…」或「命令面板 Ctrl+Shift+P」操作，功能完全一致；也可尝试：关闭 VSCode → 右键以管理员身份运行 → 重新安装 Remote - SSH 插件。
问题 2：「ssh: connect to host 211.71.149.62 port 22: Connection refused」
原因：服务器 SSH 服务未启动、端口错误、防火墙拦截；
解决：
登录服务器（物理机 / 控制面板）执行 systemctl status sshd 检查 SSH 服务，未启动则执行 systemctl start sshd；
确认服务器 SSH 端口（修改后同步到 config 文件的 Port 参数）；
服务器防火墙放行端口：ufw allow 22（Ubuntu/Debian）或 firewall-cmd --add-port=22/tcp --permanent（CentOS）。
问题 3：「Permission denied (publickey,password)」
原因：用户名 / 密码错误、服务器禁止密码登录、密钥权限错误；
解决：
核对用户名和密码，确保无误；
若服务器禁用密码登录，必须配置密钥登录（参考步骤 4 方式 2）；
本地私钥文件权限需为 600（Windows 右键属性设置，Linux/macOS 执行 chmod 600 ~/.ssh/id_rsa）。
问题 4：连接超时
原因：网络延迟高，服务器未配置心跳包；
解决：在 config 文件中添加 ServerAliveInterval 60，保存后重新连接。
⑧、总结
VSCode 连接 SSH 服务器的核心是「安装 Remote - SSH 插件 + 配置连接信息 + 验证登录」，无需纠结「远程资源管理器」图标，通过「欢迎页 Connect to…」或「命令面板」即可完成所有操作。相比纯命令行，VSCode 支持可视化编辑、插件扩展、断点调试等功能，能大幅提升远程开发 / 运维效率。
下节我们正式开课！！！
