skip to content
AI私塾

使用cline搭建python的AI编程环境

AI私塾 / / 16 分钟阅读

Table of Contents

前言

我现在使用vs code 和cline搭建一个python的web开发环境,使用fastapi这个python web框架对外提供restful api服务,现在需要搭建开发环境,搭建的开发环境需要能够访问github并提交代码,可以使用在vs code中调试fastapi 框架搭建的web服务程序,本机安装多个由conda创建的python环境,需要能够在vs code对应选择某一个python虚拟环境,需要安装cline插件,要安装python语言的格式化工具,和代码补齐插件。

一、下载和安装conda和python

在开发python项目时,通常不同的python项目会安装不同的项目依赖包,如何多个项目的包都放在一起,往往会引起包冲突,conda就是解决这个问题的一个实践方案,目前市面上有Anaconda和miniconda两个工具,我们这里选择了miniconda安装。

1.1下载miniconda

访问https://www.anaconda.com/download/success#miniconda

下载文件安装

这一步全部勾选。

在miniconda3安装目录中找到_conda.exe,重新命名为conda.exe。

将以下两个miniconda的路径设置到系统环境变量Path中。

命令行输入以下命令,返回下图,证明conda安装成功了。

1.2创建python虚拟环境

执行以下命令创建一个名为fastapi_env,并且安装了python3.12的虚拟环境。

激活fastapi_env环境

如果报错

运行一下这个bat文件:D:\ProgramData\miniconda3\Library\bin\conda.bat

继续报错

查看虚拟环境存储的配置

  • 正常路径C:\Users\Administrator\.conda\envsC:\Users\Administrator\AppData\Local\conda\conda\envs 是正常的 Conda 环境目录。

  • 临时路径C:\Users\ADMINI~1\AppData\Local\Temp\_MEI206642\envs 是一个临时目录,可能不是 Conda 的标准环境目录。如果确认不需要,可以清理或调整配置。

清除这个临时路径

又报错

CondaKeyError: 'envs_dirs': undefined in config 错误可能是由于 .condarc 文件中没有 envs_dirs 配置项,或者尝试删除一个不存在的路径。而 conda config --show envs_dirs 显示的路径可能是 Conda 默认的环境目录,或者是由于某些原因被自动添加到配置中的路径。

解决方法

  1. 手动编辑 .condarc** 文件**:

    • 找到 .condarc 文件,通常位于用户主目录下,如 C:\Users\Administrator\.condarc

    • 使用文本编辑器打开 .condarc 文件,检查 envs_dirs 配置项是否存在。

    • 如果 envs_dirs 配置项不存在,可以手动添加。例如:

    • 保存并关闭文件。

  2. 通过命令行添加路径

    • 如果不想手动编辑 .condarc 文件,可以通过命令行添加路径:

    • 然后再次运行 conda config --show envs_dirs 查看配置是否生效。

  3. 清理不必要的临时目录

    • 如果 C:\Users\ADMINI~1\AppData\Local\Temp\_MEI206642\envs 是一个不必要的临时目录,可以手动删除该目录。
  4. 检查 Conda 配置文件的来源

    • 使用以下命令查看 .condarc 文件的位置和内容:

    • 如果发现 .condarc 文件中有错误或不必要的配置,可以手动编辑或删除该文件。

注意事项

  • 在修改 .condarc 文件或执行命令时,请确保路径正确无误。

  • 如果问题仍然存在,可以尝试删除 .condarc 文件,然后重新运行 conda config --show envs_dirs,让 Conda 使用默认配置。

通过以上方法,你应该能够解决 CondaKeyError: 'envs_dirs': undefined in config 的问题,并清理不必要的临时目录。如果在操作过程中遇到任何问题,可以提供更多详细信息,以便进一步帮助你解决问题。

运行conda config –show-sources,发现目录是C:\Users\ADMINI~1\AppData\Local\Temp\_MEI207762\.condarc,而这个临时目录已经不存在了

根据你的描述,conda config --show-sources 显示的 .condarc 文件路径是 C:\Users\ADMINI~1\AppData\Local\Temp\_MEI207762\.condarc,而这个临时目录已经不存在了。这种情况可能是由以下原因导致的:

可能的原因

  1. 临时文件未清理:某些程序(如 PyInstaller 或其他打包工具)可能会在临时目录中创建 .condarc 文件,用于临时环境配置。如果这些程序运行后未正确清理临时文件,可能会导致 Conda 读取到错误的配置文件。

  2. Conda 配置文件冲突:Conda 会在多个位置搜索 .condarc 文件,包括用户主目录、系统目录等。如果这些位置中的某个 .condarc 文件被错误地修改或删除,可能会导致 Conda 读取到错误的配置。

解决方法

  1. 检查并清理临时目录

    • 手动检查 C:\Users\ADMINI~1\AppData\Local\Temp 目录,确认是否存在与 Conda 相关的临时文件或目录。如果有,可以手动删除这些文件。

    • 确保没有正在运行的程序可能会使用这些临时文件。

  2. 恢复默认配置

    • 如果不确定如何修复 .condarc 文件,可以尝试删除或重命名现有的 .condarc 文件,然后重新运行 Conda 命令,让 Conda 自动生成一个新的默认配置文件。

    • 删除用户主目录下的 .condarc 文件(如果存在):

    • 然后运行以下命令,让 Conda 重新生成默认配置:

  3. 手动创建 .condarc** 文件**:

    • 如果需要,可以手动创建一个 .condarc 文件,并添加必要的配置项。例如:

    • 将此文件保存为 C:\Users\Administrator\.condarc

  4. 检查 Conda 配置文件的来源

    • 使用以下命令查看 .condarc 文件的位置和内容:

    • 如果发现 .condarc 文件中有错误或不必要的配置,可以手动编辑或删除该文件。

  5. 重新安装 Conda

    • 如果问题仍然存在,可以尝试卸载并重新安装 Conda,以确保所有配置文件都被正确设置。

通过以上步骤,你应该能够解决由于临时目录中的 .condarc 文件导致的问题。如果在操作过程中遇到任何问题,可以提供更多详细信息,以便进一步帮助你解决问题。

总结:

删除系统中所有的.condarc文件,然后重新配置

C:\Users\Administrator\.condarc

1.3安装fastapi和uvicorn

二、下载和安装开发工具VS Code

访问https://code.visualstudio.com/

三、配置vs code的python环境

3.1、安装python插件

打开vscode 点击右边的扩展插件按钮,搜索【python】,选择如图python插件进行安装。

成功安装后显示如下

选择python的虚拟环境

3.2、安装pylint插件

这个插件用于代码静态分析,帮助你发现代码中的潜在问题。

3.3、安装Black插件

这个插件用于自动格式化 Python 代码,确保代码风格一致。

3.4、配置python环境的解释器

选择界面左下角的齿轮按钮,选择【Command Palette】按钮或者按快捷键Ctrl+Shift+P

在弹出页面的搜索栏搜索【Python: Select Interpreter】

系统会搜索电脑安装的虚拟环境,选择你想要配置的虚拟环境即可。

3.5、配置汉化插件

点击插件按钮,搜索Chinese simplified,找到微软的汉化插件并安装。

然后按快捷键组合:ctrl+shift+p,输入language,在下拉配置项目中找到“configure display language”。

在弹出选项选择简体中文,重启vs code,汉化就生效了。

四、配置vs code的git环境

好的,以下是在 Windows 11 操作系统下,使用 VS Code 配置 Git 环境、关联 GitHub 账号并提交代码的详细步骤:

1. 安装 Git

参考《git入门》这篇文章

2. 配置 Git 用户信息

  1. 打开 VS Code

    • 通过开始菜单找到并打开 VS Code。
  2. 打开终端

    • 在 VS Code 中,点击 “视图(View)” -> “终端(Terminal)” -> “新建终端(New Terminal)”。
  3. 配置全局用户名和邮箱

    • 在终端中运行以下命令,将 Your Name 替换为你的名字,将 your_email@example.com 替换为你的 GitHub 注册邮箱:

3. 关联 GitHub 账号

  1. 生成 SSH 密钥对

    • 在终端中运行以下命令生成 SSH 密钥对:

      • 如果系统不支持 ed25519,可以使用 ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
    • 按回车键接受默认的文件存储位置(通常是 C:\Users\你的用户名\.ssh\id_ed25519)。

    • 输入一个安全的密码(可选),然后再次输入以确认。

  2. 复制公钥内容

    • 打开生成的公钥文件路径(通常是 C:\Users\你的用户名\.ssh\id_ed25519.pub)。

    • 打开该文件,复制公钥内容。

  3. 将 SSH 密钥添加到 GitHub

    • 登录 GitHub,点击右上角的头像,选择 “Settings”。
    • 在左侧菜单中选择 “SSH and GPG keys”。

    • 点击 “New SSH key” 按钮。

    • 在 “Title” 中输入一个描述(例如 “My Windows 11 Laptop”),在 “Key” 中粘贴刚才复制的公钥内容。

    • 点击 “Add SSH key” 按钮完成添加。

  4. 测试 SSH 连接

    • 在终端中运行以下命令测试 SSH 连接:

    • 如果连接成功,你会看到类似以下的提示信息:

4. 克隆远程仓库(如果尚未克隆)

  1. 克隆远程仓库

    • 打开 Git Bash 或 VS Code 的终端。

    • 运行以下命令克隆远程仓库,将 yourusernameyour-repo 替换为你的 GitHub 用户名和仓库名称:

    • 克隆完成后,进入仓库目录:

5. 提交代码到远程仓库

  1. 打开项目文件夹

    • 在 VS Code 中,打开你的项目文件夹。
  2. 暂存更改

    • 在 VS Code 的底部状态栏中,点击 “源代码管理” 图标(或者使用快捷键 Ctrl+Shift+G)。

    • 在源代码管理视图中,可以看到未提交的更改。

    • 点击每个更改旁边的加号(+)或直接点击 “全部暂存” 按钮(图标是一个加号),将更改暂存到暂存区。

  1. 提交更改

    • 在 “消息” 输入框中输入提交信息,然后点击 “提交” 按钮(图标是一个勾号)。
  2. 推送代码

    • 提交完成后,点击 “推送” 按钮(图标是一个向上的箭头),将代码推送到远程仓库。

6. 验证推送结果

  1. 检查 GitHub 仓库

    • 打开浏览器,访问你的 GitHub 仓库页面。

    • 检查代码是否已经成功推送到仓库。

7. 配置 Git 的默认分支名称(可选)

  1. 更改默认分支名称

    • 如果你希望将默认分支名称从 master 改为 main,可以在终端中运行以下命令:

完成以上步骤后,你就可以在 Windows 11 操作系统下顺利地将代码推送到 GitHub 的指定仓库了。

五、配置AI编程助手cline

以下是在 VS Code 中安装和配置 Cline 插件的详细步骤:

安装 Cline 插件

  1. 打开 VS Code,点击左侧的扩展图标(快捷键 Ctrl+Shift+X)。

  2. 在扩展搜索框中输入 “Cline”,找到由 Anysphere 开发的 Cline 插件。

  1. 点击 “安装” 按钮,等待安装完成。

  2. 安装完成后,VS Code 左侧会出现一个小机器人图标,表示 Cline 插件已成功安装。

配置 Cline 插件

  1. 打开设置:点击 VS Code 左侧的 Cline 图标,进入 Cline 的设置页面。
  • 选择模型提供商:在设置页面中,点击 “API Provider” 下拉菜单,选择你想要使用的模型提供商,如 OpenAI、Deepseek、Ollama 等。
  1. 配置 API Key

    • 前往对应模型提供商的官网注册账号并获取 API Key。

    • 在 Cline 设置页面中,找到对应的 API Key 输入框,填入你的 API Key。

  2. 配置模型:在模型下拉菜单中,选择对应的模型和版本。

  1. 自定义指令(可选):根据你的需求,可以设置一些自定义指令,例如强制执行编码风格和最佳实践、提高代码质量、指导错误处理等。

  2. 权限设置(可选):配置各种系统操作权限,如文件读写、目录读写、浏览器等。

使用 Cline 插件

  1. 智能代码生成:在代码编辑器中,选择一段代码,右键点击选择 “Cline: Generate Suggestions”,插件将使用所选模型生成代码优化建议。

  2. 文件和项目管理:Cline 可以帮助你在大型项目中穿梭自如,创建、修改、浏览文件。

  1. 终端遥控器:获得用户授权后,Cline 可以直接操控终端命令并实时监控输出。

  2. 代码分析:Cline 可以帮助你查找并修复代码中的错误、重构代码、添加文档等。

注意事项

  • 确保你的 API Key 安全,不要在公共代码库中泄露。

  • 在调用 API 时,建议添加 try 重试机制,以提升代码的健壮性。

通过以上步骤,你就可以在 VS Code 中安装并使用 Cline 插件,借助 AI 助手提升你的编程效率。

相关文章