Cargo es la herramienta de compilación y administrador de paquetes predeterminado para el lenguaje de programación Rust. cargo new es un comando proporcionado por Cargo para crear un nuevo proyecto Rust. En este artículo, profundizaremos en lo que hace el comando cargo new, su sintaxis y cómo usarlo para crear proyectos de Rust. También discutiremos cómo está organizado el proyecto Rust y cómo comenzar a escribir y construir su código Rust.
Tabla de contenido
1. ¿Qué es el nuevo comando de carga?
2. ¿Por qué es importante el nuevo comando de carga?
1. Inicializar la estructura del proyecto
3. Mejorar la eficiencia del desarrollo
8¿Cómo utilizar el nuevo comando cargo?
2. Ver la estructura del proyecto
3. Compile y ejecute el proyecto.
10.La importancia y el uso de carga nueva en el ecosistema Rust
11. Algunas sugerencias sobre la gestión y mantenimiento de proyectos Rust.
1. ¿Qué es el nuevo comando de carga?
cargo new es uno de los subcomandos de la herramienta Cargo del lenguaje de programación Rust, que se utiliza para crear nuevos proyectos de Rust. La comunidad de Rust pone gran énfasis en la organización y el mantenimiento del código, por lo que al crear un nuevo proyecto, usar el comando cargo new puede ayudar a los desarrolladores a inicializar una estructura básica del proyecto.
2. ¿Por qué es importante el nuevo comando de carga?
El comando cargo new es muy importante en el desarrollo de Rust por las siguientes razones:
1. Inicializar la estructura del proyecto
Los proyectos de Rust generalmente tienen una estructura de archivos y directorios específica, incluido un directorio src (para el código fuente), un archivo Cargo.toml (para definir las dependencias y la metainformación del proyecto), etc. Estas estructuras se pueden inicializar fácilmente usando el comando cargo new sin tener que crear archivos y directorios manualmente.
2. Gestionar dependencias
La comunidad Rust utiliza Cargo para gestionar dependencias. Al utilizar el comando cargo new, puede especificar dependencias cuando se inicializa su proyecto, para que pueda comenzar a usar fácilmente otras bibliotecas y herramientas sin editar manualmente el archivo Cargo.toml.
3. Mejorar la eficiencia del desarrollo
El comando cargo new puede ayudar a los desarrolladores a iniciar rápidamente nuevos proyectos, ahorrando tiempo en la creación de estructuras de proyectos y procesos de inicialización. Esto permite a los desarrolladores centrarse más en escribir código que en configurar el proyecto.
3. Gramática básica
La sintaxis básica del comando cargo new es la siguiente:
cargo new [OPTIONS] <PROJECT_NAME>en:
- OPCIONES: Banderas opcionales utilizadas para configurar la creación del proyecto.
- <PROJECT_NAME>: El nombre del proyecto a crear.
4.Descripción
Este comando creará un nuevo paquete Cargo en el directorio especificado. Esto incluye una plantilla simple que contiene el manifiesto Cargo.toml, archivos fuente de muestra y un archivo de ignorancia del sistema de control de versiones. Si el directorio aún no está en un repositorio del sistema de control de versiones, se creará un nuevo repositorio (consulte la opción --vcs a continuación).
Para ver un comando similar que crea un nuevo manifiesto en un directorio existente, consulte comando cargo init .
5.Descripción de la opción
Nuevas opciones
- --bin: crea un proyecto ejecutable (src/main.rs) (comportamiento predeterminado).
- --lib: crea un proyecto de biblioteca (src/lib.rs).
- --edición edición: especifique la versión de Rust que se utilizará. El valor predeterminado es 2021. Los valores posibles son: 2015, 2018, 2021.
- --name nombre: establece el nombre del proyecto que se utilizará. El valor predeterminado es el nombre del directorio.
- --vcs vcs: inicializa un nuevo repositorio del sistema de control de versiones para el sistema de control de versiones determinado (git, hg, pijul o fosil), o no inicializa ningún sistema de control de versiones (ninguno). Si no se especifica, el valor predeterminado es git o el valor de configuración cargo-new.vcs, o ninguno si ya está en un repositorio del sistema de control de versiones.
- --registro de registro: establezca el campo de publicación en Cargo.toml en el nombre de registro proporcionado, lo que limitará la publicación a ese registro únicamente. El nombre del registro se define en el archivo de configuración de Cargo . Si no se especifica, el valor predeterminado es el registro predeterminado definido por la clave de configuración registro.default. Si no se establece el registro predeterminado y no se utiliza --registry, el campo de publicación no está configurado, lo que significa que la publicación no está restringida.
Por ejemplo, para crear un proyecto de biblioteca y especificar la versión Rust 2018, puede usar el siguiente comando:
cargo new --lib --edition 2018 my_libraryMostrar opciones
- -v o --verbose: muestra el proceso de creación detallado.
- -q o --quiet: no imprime mensajes de registro de carga. También se puede utilizar con el valor de configuración term.quiet.
- --color cuando: Controla cuándo se utiliza la salida en color. Los valores válidos son:
- auto (predeterminado): Detecta automáticamente si el terminal admite colores.
- siempre: muestra siempre el color.
- nunca: nunca mostrar el color. También se puede utilizar con el valor de configuración term.color .
Opciones generales
- +cadena de herramientas: si Cargo se instaló usando Rustup y el primer argumento de Cargo comienza con +, se interpretará como el nombre de la cadena de herramientas Rustup (por ejemplo, +estable o +nightly). Para obtener más información sobre la cobertura de la cadena de herramientas, consulte la documentación de Rustup .
- --config CLAVE=VALOR o RUTA: Anula los valores de configuración de Cargo. Los parámetros deben proporcionarse en sintaxis TOML con CLAVE=VALOR o como una ruta a un archivo de configuración adicional. Esta bandera se puede especificar varias veces. Consulte la sección Anulaciones de línea de comando para obtener más información .
- -C RUTA: cambia el directorio de trabajo actual antes de realizar cualquier operación especificada. Esto afecta dónde busca Cargo el manifiesto del proyecto (Cargo.toml) de forma predeterminada, así como el directorio utilizado para descubrir .cargo/config.toml, por ejemplo. Esta opción debe aparecer antes del nombre del comando, como cargo -C ruta/a/mi-proyecto compilación. Esta opción solo está disponible en el canal nocturno y requiere que el indicador -Z unstable-options esté habilitado (ver #10098 ).
- -h o --help: imprime información de ayuda.
- -Bandera Z: Bandera inestable (solo nocturna) para Carga. Ejecute cargo -Z help para obtener más detalles.
6. Variables ambientales
Consulte la documentación de referencia para obtener detalles sobre las variables de entorno leídas por Cargo.
7.Estado de salida
0: Carga ejecutada exitosamente.
101: La carga no logró completar la ejecución.
8¿Cómo utilizar el nuevo comando cargo?
Ahora veamos cómo crear un nuevo proyecto de Rust usando el comando cargo new.
1. Crea un nuevo proyecto
Para crear un nuevo proyecto Rust, simplemente ejecute el siguiente comando en la terminal:
cargo new my_projectEsto creará un nuevo proyecto llamado "my_project" en el directorio actual. Puede reemplazar el nombre del proyecto con cualquier nombre que desee.
2. Ver la estructura del proyecto
Una vez que el proyecto se haya creado correctamente, puede utilizar el comando ls para ver la estructura de archivos y directorios del proyecto. Normalmente, verá lo siguiente:
my_project/
├── Cargo.toml
└── src/
└── main.rs
- El archivo Cargo.toml es el archivo de metainformación del proyecto y se utiliza para definir dependencias y otras configuraciones.
- El directorio src/ contiene el código fuente de Rust del proyecto y generalmente incluye un archivo main.rs como punto de entrada del proyecto.
3. Compile y ejecute el proyecto.
Una vez que el proyecto se haya creado correctamente, puede utilizar los siguientes comandos para crear y ejecutar el proyecto:
cd my_project
cargo build # 构建项目
cargo run # 运行项目El comando cargo build compilará el proyecto, mientras que el comando cargo run ejecutará el ejecutable compilado.
9Estructura del proyecto
La función principal del comando cargo new es crear una nueva estructura de proyecto, que contiene un diseño de proyecto estándar de Rust. La estructura de este proyecto generalmente incluye lo siguiente:
- Cargo.toml: Archivos de configuración de dependencias y metadatos del proyecto.
- Directorio src: el directorio que contiene el código Rust.
- src/main.rs o src/lib.rs: el archivo de entrada del proyecto, dependiendo de si es un proyecto ejecutable o un proyecto de biblioteca.
- .gitignore: Lista de archivos a ignorar desde el control de versiones.
- Directorio .git (si usa Git para el control de versiones): contiene archivos relacionados con el control de versiones de Git.
Dependiendo de la complejidad y las necesidades de su proyecto, puede crear más archivos de código fuente de Rust en el directorio src/ para dividir diferentes módulos y funciones. Esto ayuda a mantener su código organizado y mantenible.
10.La importancia y el uso de carga nueva en el ecosistema Rust
cargo new es un comando muy importante en el lenguaje de programación Rust que simplifica el proceso de creación de nuevos proyectos. La comunidad de Rust enfatiza la mantenibilidad y el diseño modular de los proyectos, y el comando cargo new ayuda a garantizar que los nuevos proyectos sigan estas mejores prácticas. Al generar automáticamente una estructura de proyecto estándar, se reduce la complejidad de la configuración inicial para que los desarrolladores puedan comenzar a escribir código más rápido.
Además, el archivo Cargo.toml es el archivo de configuración principal del proyecto Rust y contiene la información de metadatos y las dependencias del proyecto. El proyecto creado por el comando cargo new ya contiene un archivo Cargo.toml mínimo, donde puede agregar y administrar las dependencias del proyecto, lo cual es crucial para usar bibliotecas y herramientas en el ecosistema Rust.
11. Algunas sugerencias sobre la gestión y mantenimiento de proyectos Rust.
Una vez que crea un proyecto de Rust utilizando carga nueva, la gestión y el mantenimiento del proyecto se vuelven cruciales. Aquí hay algunas sugerencias:
- Actualice las dependencias con regularidad: utilice el archivo Cargo.toml para administrar las dependencias del proyecto y ejecute el comando de actualización de carga con regularidad para actualizar las versiones de las dependencias.
- Pruebas de redacción: Rust fomenta la redacción de pruebas unitarias y de integración para garantizar la estabilidad y confiabilidad del proyecto.
- Utilice el control de versiones: coloque el proyecto en un sistema de control de versiones (como Git) para rastrear y administrar los cambios de código.
- Lea la documentación de Rust: la comunidad de Rust proporciona una gran cantidad de documentación y tutoriales para ayudarle a comprender y utilizar mejor Rust.
- Participa en la comunidad: la comunidad de Rust es muy activa y participar en debates comunitarios y contribuir a proyectos de código abierto puede ayudarte a aprender y crecer.
12.Conclusión
cargo newLos comandos son una herramienta importante para crear proyectos de Rust. Al utilizar este comando, puede inicializar rápidamente un nuevo proyecto de Rust y comenzar a escribir código. Comprender la estructura organizativa de un proyecto y cómo personalizar las plantillas de proyecto puede ayudarle a gestionar y desarrollar mejor los proyectos de Rust. Espero que este artículo te ayude a comprender y utilizar mejor cargo newlos comandos. Si desea obtener más información sobre el lenguaje de programación Rust y las herramientas Cargo, se recomienda consultar la documentación oficial de Rust para obtener más información.