在正式开课之前需要在本地搭建好开发测试环境,这是一切的基础!
一、如何在本地运行代码
要在本地运行代码,您需要安装某个版本的 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 支持可视化编辑、插件扩展、断点调试等功能,能大幅提升远程开发 / 运维效率。
下节我们正式开课!!!