在 Visual Studio Code (VSCode) 中完成环境配置指南的操作,笔者按照以下步骤进行:
1. 生成 SSH key
在 VSCode 中,打开一个新的终端(Terminal -> New Terminal
或按 Ctrl+`
)并执行以下命令:
ssh-keygen -t rsa -C "youremail@example.com"
按照提示完成密钥的生成过程。
2. 将公钥添加到 GitHub
继续在 VSCode 的终端中使用以下命令来查看并复制 SSH 公钥:
cat ~/.ssh/id_rsa.pub
复制输出的内容,然后在网页浏览器中打开 GitHub,依次点击右上角头像 -> Settings -> SSH and GPG keys -> New SSH key,将复制的公钥粘贴到 key 输入框中,并点击 "Add SSH key"。
3. 安装 Conda 环境(Windows 环境)
在 VSCode 终端中,可以通过以下命令下载并安装 Miniconda:
curl https://repo.anaconda.com/miniconda/Miniconda3-latest-Windows-x86_64.exe -o miniconda.exe
然后,可以手动点击下载好的 miniconda.exe
文件进行安装,或者在命令行中执行安装(可能需要图形界面支持,推荐手动点击安装)。
安装完成后,检查 Conda 是否安装成功:
conda --version
删除安装包:
del miniconda.exe
4. 新建虚拟环境
在 VSCode 的终端中执行:
conda create -n llm-universe python=3.10
5. 激活虚拟环境
在 VSCode 的终端中执行:
conda activate llm-universe
6. 克隆当前仓库
确保你的 SSH key 已添加到 GitHub,然后在 VSCode 的终端中执行:
git clone git@github.com:datawhalechina/llm-universe.git
7. 安装所需的包
在 VSCode 的终端中,首先切换到仓库目录:
cd llm-universe
然后安装依赖:
pip install -r requirements.txt
通过这些步骤,可以在 VSCode 内完成环境的设置和项目的准备工作。如果在操作过程中遇到任何问题,可以查询相关的 VSCode 或 Conda 文档,或者在这里提问获取帮助。
一些个补充:
①在命令 ssh-keygen -t rsa -C "youremail@example.com"
中,"youremail@example.com"
是一个标识符,用来在生成的 SSH key 中作为注释。这个邮箱地址没有技术上的功能作用,而是帮助识别和管理使用这个 SSH key 的用户。
作用和意义
-
标识作用:当在服务器或多个服务上使用多个 SSH keys 时,这个邮箱地址作为注释,可以帮助你快速识别每个 key 的用途和所属用户。这在管理多个 key 时非常有用,尤其是在团队环境中,每个成员可能需要管理和识别多个 keys。
-
默认注释:
ssh-keygen
命令在生成 key 时默认会要求输入一个注释,使用者的邮箱地址是一种常见的注释方式。这不仅帮助个人用户记住这个 key 是与哪个账户相关联的,也方便了团队管理。
使用场景
举个例子,假如笔者正在为自己在 GitHub 的账户生成一个 SSH key,可能会用与 GitHub 账户相关联的邮箱地址作为注释。这样,当查看 .ssh/id_rsa.pub
文件内容时,可以看到这样的一行:
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC3... user@example.com
这里的 user@example.com
就是你生成 key 时使用的邮箱地址,它出现在公钥文件的末尾,作为对该公钥的简单描述或标识。在 ssh-keygen
命令中用的邮箱应该是一个用来标识这个 key 的地址,它不会用于发送邮件或接收邮件,只是作为一种标记。在实际使用中,可以选择任何有意义的标记,但用个人或工作相关的邮箱地址是最常见的做法。
总结说明
此章环境配置部分涉及了多个关于如何使用Visual Studio Code (VSCode)、SSH密钥管理、以及如何安装和配置Conda环境的实用技术指导。首先,SSH key的生成和管理是确保远程服务器安全访问的关键步骤。通过SSH key,用户可以安全地连接到GitHub等平台,而无需每次操作时输入密码。特别是在多人协作和版本控制的场景中,有效的密钥管理显得尤为重要。
其次,如何在VSCode中安装和配置Python环境。这一部分涉及从下载安装包到配置环境变量,再到验证安装成功的步骤。通过这些操作,可以为项目搭建一个干净、隔离的开发环境,有助于项目的依赖管理和后续的维护工作。
无论是软件开发还是日常的项目管理,了解并掌握一些基本的工具和命令行操作是非常有必要的。它们不仅可以提高我们的工作效率,还能在处理复杂问题时提供帮助。