Data Science for Beginners 环境搭建实战指南:从 GitHub Codespaces 到本地数据科学开发环境 📅 发布时间:2026/9/11 21:14:54 👁 浏览次数: Data Science for Beginners 环境搭建实战指南从 GitHub Codespaces 到本地数据科学开发环境【免费下载链接】Data-Science-For-Beginners10 Weeks, 20 Lessons, Data Science for All!项目地址: https://gitcode.com/GitHub_Trending/da/Data-Science-For-Beginners本指南以 Data Science for Beginners 开源课程仓库的官方安装文档INSTALLATION.md为骨架系统讲解如何为零基础学习者搭建完整的课程学习环境既包括零配置的 GitHub Codespaces 云端快速开始方案也包括 Git、Python/Jupyter、Node.js 与 Docsify 的完整本地安装流程并覆盖 quiz 小测应用、文档站与数据科学 notebook 的逐项验证方法。读完本指南你将能独立完成从克隆仓库到跑通第一个数据科学 notebook 的全过程并了解仓库内各组件quiz-app、docsify 文档站、examples 示例脚本的真实依赖与配置细节。一、安装前置条件在开始安装之前官方文档建议学习者确认自己具备以下基础条件命令行/终端的基本使用经验后续所有安装与验证步骤都依赖 shell 命令一个 GitHub 账号免费用于云端开发环境Codespaces的创建以及后续可能的参与贡献与提问稳定的网络连接首次安装需要下载依赖与克隆仓库网络稳定性直接影响初始体验。对于完全没有任何开发经验的学习者官方推荐直接使用GitHub Codespaces下一节它可以把环境搭建环节降到最低把精力集中在课程内容本身。二、快速开始GitHub Codespaces初学者首选GitHub Codespaces 会在浏览器中提供一个完整的开发环境仓库的 README.md 顶部也提供了Open in GitHub Codespaces入口徽章。官方安装文档给出的创建步骤如下进入 Data Science for Beginners 仓库页面点击页面上的Code下拉菜单选择Codespaces标签页点击Create codespace on main等待环境初始化完成约 23 分钟。初始化完成后你的环境中即已预装全部课程依赖Python、Jupyter 等可以直接打开各课程目录下的.ipynbnotebook 开始学习无需任何本地配置。这种方式特别适合首次接触数据科学的纯初学者临时设备如公共电脑、平板上的学习教室环境下的统一配置详见 for-teachers.md 中的教师建议USAGE.md 也推荐教师使用 GitHub Classroom 或 Codespaces 建立共享环境。提示仓库包含 50 语言翻译体积较大。若选择本地克隆且不需要翻译内容可参考 README.md 提供的sparse checkout稀疏检出方式加速下载详见下文克隆仓库一节。三、本地安装逐步搭建数据科学开发环境如果你希望在自己的电脑上进行本地开发请按以下 8 个步骤依次执行。步骤 1安装 GitGit 用于克隆仓库并跟踪你的代码变更。官方文档给出的各平台安装方式如下Windows从 git-scm.com 下载 Windows 安装包使用默认设置完成安装。macOS通过 Homebrew 安装brew install git或从 git-scm.com 下载 macOS 版本安装。Linux# Debian/Ubuntu sudo apt-get update sudo apt-get install git # Fedora sudo dnf install git # Arch sudo pacman -S git安装完成后可在终端执行git --version确认安装成功此命令为安装自检的通用做法。步骤 2克隆仓库# 克隆仓库 git clone https://github.com/microsoft/Data-Science-For-Beginners.git # 进入仓库目录 cd Data-Science-For-Beginners进阶跳过翻译目录以加速克隆sparse checkout由于仓库内含 50 语言的完整翻译如 translations/bn/与translated_images图片资源完整克隆体积较大。README.md 明确给出了排除翻译目录的稀疏检出方案Bash / macOS / Linuxgit clone --filterblob:none --sparse https://github.com/microsoft/Data-Science-For-Beginners.git cd Data-Science-For-Beginners git sparse-checkout set --no-cone /* !translations !translated_imagesCMD (Windows)git clone --filterblob:none --sparse https://github.com/microsoft/Data-Science-For-Beginners.git cd Data-Science-For-Beginners git sparse-checkout set --no-cone /* !translations !translated_images该方式只检出课程本体6 大章节 数据 示例 quiz-app足以完成全部课程学习下载速度快得多。步骤 3安装 Python 和 Jupyter课程的数据科学 lesson 要求Python 3.7 或更高版本examples 目录的示例脚本也要求 Python 3.7参见 examples/README.md。Windows从 python.org 下载 Python 安装包安装时务必勾选Add Python to PATH验证安装python --versionmacOS# 通过 Homebrew 安装 brew install python3 # 验证安装 python3 --versionLinux# 大多数 Linux 发行版已预装 Python python3 --version # 若未安装 # Debian/Ubuntu sudo apt-get install python3 python3-pip # Fedora sudo dnf install python3 python3-pip注意Windows 上通常使用python命令macOS/Linux 上通常使用python3。若出现python: command not found或版本不符TROUBLESHOOTING.md 给出了通过alias pythonpython3建立别名或显式使用python3的解决办法。步骤 4配置 Python 虚拟环境官方文档强烈建议使用虚拟环境以隔离不同项目的依赖避免版本冲突# 创建虚拟环境 python -m venv venv # 激活虚拟环境 # Windows: venv\Scripts\activate # macOS/Linux: source venv/bin/activate激活成功后终端提示符前会出现(venv)前缀。若激活遇到问题TROUBLESHOOTING.md 提供了两类常见修复Windows 执行策略错误Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser后再激活macOS/Linux 无执行权限chmod x venv/bin/activate后再激活。步骤 5安装 Python 数据科学包在激活的虚拟环境中安装课程所需的全部数据科学库pip install jupyter pandas numpy matplotlib seaborn scikit-learn各库在课程中的用途jupyter运行各 lesson 目录下.ipynbnotebook 的核心环境pandas表格数据读取、清洗与统计分析课程中大量使用pd.read_csv读取 data/ 目录下的数据集numpy数值计算与数组运算基础matplotlib基础绘图折线图、柱状图、散点图等seaborn基于 matplotlib 的高级统计可视化scikit-learn机器学习建模相关 lesson如第 4 章数据科学生命周期所用。你可以通过pip install jupyter pandas numpy matplotlib seaborn scikit-learn一条命令安装全部依赖也可以按需单独安装。若安装时遇到权限或 SSL 错误TROUBLESHOOTING.md 建议使用--user标志、先升级 pippython -m pip install --upgrade pip等方式处理。仓库佐证仓库根目录的 package.json 仅面向文档工具docsify-to-pdf 用于将文档导出为 PDF课程 Python 依赖并没有统一的 requirements.txt因此官方采用上述 pip 命令直接安装的方式data/目录下已随仓库附带全部课程数据集如birds.csv、mushrooms.csv、diabetes.tsv及 COVID 时间序列数据等克隆仓库后无需额外下载数据。步骤 6安装 Node.js 和 npm用于 quiz 小测应用课程每个 lesson 都包含课前/课后小测quiz小测应用quiz-app基于 Vue.js 构建需要 Node.js 和 npm 才能本地运行。Windows/macOS从 nodejs.org 下载安装包官方文档建议LTS 版本运行安装程序即可。LinuxDebian/Ubuntu# 警告将互联网脚本直接管道到 bash 存在安全风险。 # 官方建议先下载脚本并审查再执行 # curl -fsSL https://deb.nodesource.com/setup_lts.x -o setup_lts.x # less setup_lts.x # 然后运行 # sudo -E bash setup_lts.x # # 或者自行承担风险使用一行命令 curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - sudo apt-get install -y nodejs # Fedora sudo dnf install nodejs # 验证安装 node --version npm --version若npm run serve启动失败TROUBLESHOOTING.md 提示检查 Node.js 版本12.x 或更高并可执行npm install --legacy-peer-deps解决依赖冲突。步骤 7安装 quiz 小测应用依赖# 进入 quiz 应用目录 cd quiz-app # 安装依赖 npm install # 返回仓库根目录 cd ..从 quiz-app/package.json 的源码可以看到该应用的真实技术栈前端框架Vue 2.6.11vue路由vue-router 3.4.9国际化vue-i18n 8.22.2支持多语言小测构建工具vue/cli-service 4.5.x其scripts中定义了serve/build/lint三个命令。步骤 8安装 Docsify可选用于离线阅读文档若希望在没有网络的情况下离线浏览课程文档可全局安装 docsify-clinpm install -g docsify-cli仓库根目录的 index.html 是 docsify 的入口页面其中通过window.$docsify完成了站点配置如站点名称Data Science for Beginners、开启relativePath: true相对路径模式以正确解析多级目录下的文档链接并使用 docsify-themeable 主题侧边栏目录由 docs/_sidebar.md 定义覆盖了 6 大章节 20 个 lesson 的完整导航结构。安装 docsify-cli 后即可用docsify serve在本地拉起整个文档站见下文验证部分。四、验证你的安装安装完成后官方文档要求逐项验证三套环境是否就绪。1. 验证 Python 与 Jupyter# 若虚拟环境尚未激活 # Windows: venv\Scripts\activate # macOS/Linux: source venv/bin/activate # 启动 Jupyter Notebook jupyter notebook浏览器会自动打开 Jupyter 界面此时你可以导航到任意 lesson 的.ipynb文件。仓库中如 1-Introduction/01-defining-data-science/notebook.ipynb、2-Working-With-Data/07-python/notebook.ipynb、3-Data-Visualization/09-visualization-quantities/notebook.ipynb 等均为可直接运行的实战 notebook。常用验证小技巧来自 USAGE.md执行单元格Shift Enter全部执行菜单Cell → Run All内核卡死菜单Kernel → Restart图表不显示时在 notebook 顶部添加%matplotlib inline。2. 验证 quiz 小测应用# 进入 quiz 应用目录 cd quiz-app # 启动开发服务器 npm run serve小测应用应可通过http://localhost:8080访问若 8080 端口被占用Vue CLI 会自动切换到其他端口也可用npm run serve -- --port 8081手动指定。仓库的 USAGE.md 说明了小测的编号规则全课程共 40 个小测编号 039每个 lesson 通常包含课前与课后各一个每个小测 3 道题用于强化记忆而非穷尽考核。3. 验证文档服务器docsify# 在仓库根目录执行 docsify serve文档站应可通过http://localhost:3000访问。若docsify: command not foundTROUBLESHOOTING.md 提供了全局安装npm install -g docsify-cli、检查 npm 全局路径npm config get prefix与 PATH 配置等完整修复方案。五、进阶方案VS Code Dev Containers如果你本机安装了 Docker官方文档还提供了第三种运行方式——VS Code Dev Containers可在隔离的容器中运行完整开发环境安装 Docker Desktop安装 Visual Studio Code安装Remote - Containers扩展在 VS Code 中打开仓库按F1选择Remote-Containers: Reopen in Container等待容器首次构建完成仅第一次需要。容器构建完成后Python、Node.js 等依赖均在容器内就绪宿主机无需安装任何开发工具适合需要在多台机器间保持环境一致的场景。六、安装后的下一步与常见问题学习路径与使用方式安装验证完成后官方建议按以下顺序继续阅读 README.md 了解 20 个 lesson 的课程全貌与 6 大章节结构Introduction → Working With Data → Data Visualization → Data Science Lifecycle → Data Science in the Cloud → Data Science in the Wild参考 USAGE.md 掌握课程的标准学习工作流课前小测 → 阅读 → notebook 实操 → 作业 → 课后小测以及 4 种常见学习路径完整入门路径、专题学习、项目驱动、云端数据科学从 examples/ 目录开始快速热身该目录包含 5 个自包含、带详细注释的入门脚本01_hello_world_data_science.py 到 05_real_world_example.py覆盖加载数据、基础分析、可视化与真实数据完整流程仅需pip install pandas numpy matplotlib即可运行是验证环境是否就绪的最快途径遇到问题优先查阅 TROUBLESHOOTING.md。常见问题速查现象快速定位python: command not found或版本不对检查 PATH或建立alias pythonpython3见 TROUBLESHOOTING.md Python and Jupyter Issues虚拟环境无法激活Windows 调整执行策略macOS/Linux 检查脚本可执行权限ModuleNotFoundError: No module named pandas确认虚拟环境已激活并执行pip install pandasjupyter notebook命令找不到pip install jupyter或使用python -m jupyter notebooknpm install失败npm cache clean --force后重装必要时npm install --legacy-peer-deps8080 端口被占用npm run serve -- --port 8081或按系统命令结束占用进程docsify 命令不存在npm install -g docsify-cli并检查 npm 全局 bin 是否在 PATH 中读取数据报FileNotFoundError检查当前工作目录os.getcwd()使用../data/xxx.csv相对路径七、多语言说明本安装指南的关联文档为仓库官方多语言翻译体系的一部分translations/bn/INSTALLATION.md 是孟加拉语版本与根目录英文原版 INSTALLATION.md 内容保持一致。仓库通过自动化翻译流程维护 50 语言的课程文档与图片资源语言列表见 README.md不同语言版本的安装步骤、命令与配置完全相同只是说明文字语言不同。若翻译与英文原版存在出入应以英文原版 INSTALLATION.md 为准。关于本文档本文内容以仓库安装文档为核心骨架并结合 quiz-app/package.json、index.html、docs/_sidebar.md、examples/README.md、USAGE.md、TROUBLESHOOTING.md 等仓库源码与文档完成了纵深印证确保每条命令与每个配置项都可在此仓库中找到真实依据。【免费下载链接】Data-Science-For-Beginners10 Weeks, 20 Lessons, Data Science for All!项目地址: https://gitcode.com/GitHub_Trending/da/Data-Science-For-Beginners创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考