记录配置Anaconda作为Python开发环境,以及使用VSCode作为Python和Markdown编辑器的配置过程。
本文主要介绍Windows7环境下安装并配置Anaconda+VSCode作为Python开发环境和Markdown编辑器。
Anaconda与包管理配
Anaconda 是一个用于科学计算的 Python 发行版,支持 Linux, Mac, Windows, 包含了众多流行的科学计算、数据分析的 Python 包。同时,使用Anaconda能够便捷的获取包且对包能够进行管理,同时对环境可以统一管理的发行版本。Anaconda包含了conda、Python在内的超过180个科学包及其依赖项。
Anaconda安装
Anaconda软件安装包可以直接前往官网下载所需的版本,目前提供Python3.8版本,选择Windows平台下“64-Bit Graphical Installer”或“32-Bit Graphical Installer”进行下载
安装包下载完成后,运行安装程序即开始Anaconda的安装,根据向导完成安装即可。安装很简单,需要注意的点有:
- 在选择安装类型(select Installation Type)时,分为“Just Me”和“All Users”。默认选择为“All Users”,但通常改为“Just Me”,只为当前用户安装即可。若需要为所有用户安装,则安装程序必须以管理员权限运行,否则安装完后会无法使用(如无法运行Anaconda Prompt等各种应用)。
- 设置安装路径时,可以使用默认的安装路径,也可以自定义安装路径。但是安装路径中最好不要出现中文和空格,否则后续使用中可能出现问题。
添加环境变量
安装完成后,需要添加*\Anaconda3
、*\Anaconda3\Scripts
、*\Anaconda3\Library\bin
三个路径为系统环境变量,否则在命令行中运行conda
、pip
、Jupyter
等命令时可能出现“不是内部或外部命令,也不是可运行的程序或批处理文件”的错误信息。
Anaconda安装错误及解决
Anaconda安装完成后可能会出现一些问题,我遇到的问题和解决方案如下。
找不到Anaconda
安装完成后,可能出现在开始菜单找不到Anaconda,进入Anaconda安装目录直接运行程序也无法启动的问题。这是由于运行安装程序时未以管理员身份运行,在选择安装类型时又默认选择了“All Users”,安装程序权限不足导致的。需要卸载当前的Anaconda后重新安装,重新安装可以选择
- 在选择安装类型时选择“Just Me”
- 若安装类型要选择“All Users”,则需以管理员权限运行安装程序(在安装程序上“右键-以管理员身份运行”)
Navigator和Jupyter闪退
安装完成后,可能出现安装成功,“Anaconda Prompt”能够使用,但是“Anaconda Navigator”、“Jupyter Notebook”和“Spyder”等应用都无法打开的情况。上网所有热门答案都是说更新“Anaconda Navigator”,但是我在运行conda update anaconda-navigator
时就一直出错无法继续,最后意外看到一篇博文解决问题。
具体解决办法为:
把Anaconda安装路径“Anaconda3/Library/bin ”下面的两个文件
libcrypto-1_1-x64.dll
和libssl-1_1-x64.dll
复制到路径“Anaconda3/DLLs”下。
复制完成后,“Anaconda Navigator”等应用即能正常使用。
包管理
Python拥有众多的包,开发中通常使用conda、pip等进行包的管理。但是,由于conda和pip等服务器都位于国外,使用默认设置网速会很慢,因此,最好切换为国内源,或使用梯子进行代理。
需要注意的是,如果电脑中同时安装有Python2和Python3两个版本,使用pip命令很可能会混淆。因此,在对Python3版本使用pip命令时,最好使用pip3
命令。
conda
conda切换国内源
由于官网的镜像在境外,访问太慢或者不能访问,为了能够加快访问的速度,建议更改为国内镜像源,一般情况下,清华源更快些。
- 更换清华源在“Anaconda Prompt”中输入以下命令
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/msys2/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/pytorch/
conda config --set show_channel_urls yes
- 中科大源使用以下命令
conda config --add channels https://mirrors.ustc.edu.cn/anaconda/pkgs/main/
conda config --add channels https://mirrors.ustc.edu.cn/anaconda/pkgs/free/
conda config --add channels https://mirrors.ustc.edu.cn/anaconda/cloud/conda-forge/
conda config --add channels https://mirrors.ustc.edu.cn/anaconda/cloud/msys2/
conda config --add channels https://mirrors.ustc.edu.cn/anaconda/cloud/bioconda/
conda config --add channels https://mirrors.ustc.edu.cn/anaconda/cloud/menpo/
conda config --set show_channel_urls yes
- 如果不想再使用国内源,需要切换回默认源,使用
conda config --remove-key channels
命令
conda设置代理
使用conda安装包时可以使用代理。conda支持http和sock5等各种代理,通过修改conda的.condarc
文件实现,配置文件设置见下。若要使用http代理,将socks5
修改为http
即可。
channels:
- https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/pytorch/
- https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/
- https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/
- defaults
proxy_servers:
http: socks5://127.0.0.1:1080
ssl_verify: False
show_channel_urls: True
该文件通常位于C:\User\用户名
目录下。需要注意的是,该文件时一个可选配置文件,即当用户第一次使用conda config命令后,系统才会自动创建.condarc文件。因此,若找不到该文件,可以先使用conda config --set show_channel_urls yes
等命令后再寻找。
conda安装包时抛出“Collecting package metadata (current_repodata.json): failed”错误
参考博客,通常由于update repo
信息时网络有问题, 于是就出现了污染。使用conda clean -i
命令清除以前的repodata后重新安装包即可。
pip
pip切换国内源
参考博客。
将pip切换为国内源可以显著提升下载速度,通常使用豆瓣源。pip切换国内源包括临时切换和永久切换两种。
- 若只是临时切换,安装时使用
pip3 install 包名 -i 国内源地址
即可,如pip install scrapy -i https://pypi.tuna.tsinghua.edu.cn/simple
- 若要永久切换,首先需要在user目录中创建一个pip目录,如:C:\Users\xx\pip,新建文件pip.ini,然后将内容修改如下,即永久切换为豆瓣源。
[global]
index-url = http://pypi.douban.com/simple
[install]
use-mirrors =true
mirrors =http://pypi.douban.com/simple/
trusted-host =pypi.douban.com
pip设置代理
为pip设置代理需要首先安装pysocks包,然后设置代理服务器即可
pip3 install pysocks
pip3 install -r requirements.txt --proxy='socks5://127.0.0.1:1080'
完全卸载Anaconda
参考博客 当Anaconda出现问题时,我们可能需要彻底卸载Anaconda,卸载步骤如下
- 使用anaconda-clean包来,可以清除anaconda的相关数据。
anaconda-clean --yes
语句会不加确认的直接删除anaconda相关数据,如果需要逐条确认,可以去掉yes参数。
conda install anaconda-clean
anaconda-clean --yes
- 使用Anaconda安装目录下自带的
uninstall.exe
卸载程序进行卸载,卸载完成后重启。 - 搜索名称包含Anaconda的文件夹,直接全部删除。至此Anaconda被彻底卸载干净。
VSCode安装与配置
VSCode的安装直接从官网下载安装即可,无任何特别之处。
VSCode常见配置
为了使VSCode更加好用,需要安装一些插件并调整一些配置
修改为中文
VSCode若要进行汉化,只需在插件栏中搜索“Chinese”,找到中文语言包Chinese (Simplified) Language Pack for Visual Studio Code
安装即可。
VSCode插件配置
Python相关插件配置
Python插件
安装Python插件即可实现对Python最基本的支持,包括运行、调试等。直接安装插件即可,无需配置。
智能提示Visual Studio IntelliCode
实现对Python、TypeScript、JavaScript等语言的智能提示,直接安装插件即可,无需配置。
Anaconda Extension Pack
从特别版本开始,Anaconda安装包不再集成VSCode,在Anaconda Nagivator中不在显示VSCode。当需要在VSCode中使用Anaconda相关,如Jupyter时,最好安装该插件。
Todo Tree
用于实现对ToDo标记的支持,若对ToDo标记没有需求可以不安装。安装完插件后,无需配置,直接在注释中添加TODO
即可识别,对于Python,使用# TODO:
。在“TODOs栏”中可查看当前存在的ToDo,如下图所示。
Markdown相关插件配置
VScode默认支持编写Markdown,但是如果要高效使用的话,最好搭配插件使用,我配置的插件如下:
Markdown Preview Enhance
用于更好的对Markdown进行渲染,安装完成后点击页面右上角的预览按钮即可进行侧边预览。
Markdown TOC
更好的生成Markdown目录。
Paste Image
用于更方便的在Markdown中插入图片并保存至本地。使用快捷键Ctrl+Alt+V即可将粘贴板中的图片复制到设置好的文件夹中,并在Markdown中引用
为了实现使插入图片自动复制到Markdown文档名.assets目录下,配置包括:
- Base Path设置为
${currentFileDir}
,根目录设置为当前文件目录,即为相对路径 - Path设置为
${currentFileDir}/${currentFileNameWithoutExt}.assets
,即图片粘贴至当前目录/当前文件名.assets
目录下,若目录不存在则会自动创建。
PicGo
为了更方便的在Markdown中插入图片并上传至图床中。配置github作为图床参考另一篇博文VScode+PicGo+Github+jsdelivr使用图床书写Markdown
Markdown All in One
更好的Markdown支持,包括各种常用快捷键等。
Markdown+Math
更好的对Markdown Latex公式中的数学符号进行支持。
其他数据支持
Excel及csv数据
- Excel Viewer插件可以以只读方式查看excel文件,还可以以表格形式查看csv文件。
其他配置
汉化Chinese (Simplified) Language Pack for Visual Studio Code
安装Chinese中文语言包即可。
图标优化vsvode-icons
安装vscode-icons插件即可。
本地文件记录Local History
Local History可以记录文件的修改历史。可以随时将文件与历史记录中的任何旧版本进行比较。每次修改文件时,旧内容的副本都会保留在本地历史记录中,每个文件修订版都存储在工作空间目录.history文件夹内的单独文件中。
安装插件后,可以在资源管理器中看到local-history
窗格,其中可以查看当前文件的所有历史记录
koroFileHeader添加文件头注释和函数注释
koroFileHeader插件可以在创建文件时为文件添加文件头注释和函数注释,如作者信息,修改时间等。
快捷键
- 添加文件头注释Ctrl+Alt+I
- 添加函数注释Ctrl+Alt+F (默认快捷键为Ctrl+Alt+T,但是我电脑上这个快捷键无效,所以修改为Ctrl+Alt+F F为function)
参数设置
在setting.json中添加一下参数设置即可:
//配置新建文件注释和方法注释
"fileheader.configObj": {
"createFileTime": true,//设置为true则为文件新建时候作为date,否则注释生成时间为date
"autoAdd": true,//自动生成注释,老是忘记时可以设置
"annotationStr": {
"head": "/*",
"middle": " * @",
"end": " */",
"use": true//设置自定义注释可用
},
"headInsertLine": {
"php": 2
}
},
"fileheader.cursorMode": {
"description":"",
"param ":"",
"return":""
},
"fileheader.customMade": {
"Description":"" ,//文件内容描述
"Author":"DJ",//编辑人
"Date": "Do not edit",//时间
"LastEditTime": "Do not edit",
"LastEditors": "DJ",
}
修改函数注释快捷键
在"菜单栏-文件-首选项-键盘快捷方式"或Ctrl+K Ctrl+S进入键盘快捷方式设置,在搜索框输入"cursorTip",将该项对应的快捷方式修改为Ctrl+Alt+F
通过以上操作,VSCode和Anaconda基本配置完成,可以开始搬砖了……