5分钟快速开始：运行CS146S作业代码
本指南帮助你在5分钟内设置环境并运行一个示例作业，体验现代Python开发流程。
环境要求
支持的操作系统
运行环境
所需工具
管理Python环境
安装项目依赖
操作步骤
安装Anaconda并创建环境
下载并安装Anaconda，然后创建一个Python 3.12的Conda环境。
conda create -n cs146s python=3.12conda activate cs146s预期结果：：环境激活后，终端提示符可能显示(cs146s)，表示成功。
如果conda命令未找到，请重启终端或手动添加Anaconda到PATH。
安装Poetry
在激活的Conda环境中安装Poetry依赖管理工具。
pip install poetry预期结果：：安装完成后，运行poetry --version应显示版本号，如1.8.0。
确保在激活的Conda环境中执行此命令，以避免全局安装冲突。
克隆项目并安装依赖
下载项目代码并使用Poetry安装所有依赖包。
git clone https://github.com/mihail911/modern-software-dev-assignments.gitcd modern-software-dev-assignmentspoetry install预期结果：：Poetry安装过程会显示进度，最后提示'Installing dependencies from lock file'或类似信息，表示成功。
如果网络慢，可以设置Poetry镜像源加速下载。
运行一个示例作业
选择一个简单作业（如assignment1）并执行其主脚本，快速验证设置。
cd assignment1python main.py预期结果：：脚本输出可能包括'Hello, World!'或作业特定结果，无错误信息即表示成功运行。
如果assignment1不存在，请检查项目结构，尝试其他作业目录如intro或basics。
验证成功
完成以上步骤后，你应该能看到作业脚本的输出，确认环境配置正确。
快速提示
使用conda list和poetry show检查已安装包
如果遇到权限问题，在命令前加sudo（Linux/macOS）或以管理员运行（Windows）
参考项目README获取详细作业说明和测试方法
常见问题
conda命令未找到
重启终端或手动添加Anaconda安装路径到系统PATH变量。
poetry install失败，提示网络错误
设置Poetry镜像源，例如：poetry config repositories.pypi https://pypi.tuna.tsinghua.edu.cn/simple
python main.py报错ModuleNotFoundError
确保在激活的Conda环境中，并且已运行poetry install安装所有依赖。
下一步
探索其他作业
尝试运行assignment2或更高阶作业，学习更多开发实践。
运行测试
使用pytest运行项目测试，验证代码质量。
查看课程材料
访问项目文档或课程网站，深入了解现代软件开发概念。
相关项目推荐
public-apis/public-apis
免费API资源汇总列表
EbookFoundation/free-programming-books
📚 免费提供的编程书籍
donnemartin/system-design-primer
学习如何设计大规模系统。为系统设计面试做准备。包含Anki记忆卡片。
vinta/awesome-python
精心整理的优质Python框架、库、软件及资源列表
TheAlgorithms/Python
所有算法均使用Python实现
Significant-Gravitas/AutoGPT
AutoGPT致力于实现人人可用的普惠AI，让每个人都能使用和构建AI。我们的使命是提供工具，让您专注于重要事务。