Compreensão aprofundada do novo comando cargo: uma ferramenta poderosa para criar projetos Rust

Cargo é a ferramenta de construção padrão e gerenciador de pacotes para a linguagem de programação Rust. cargo new é um comando fornecido pelo Cargo para criar um novo projeto Rust. Neste artigo, nos aprofundaremos no que o comando cargo new faz, sua sintaxe e como usá-lo para criar projetos Rust. Também discutiremos como o projeto Rust é organizado e como começar a escrever e construir seu código Rust.

Índice

1.Qual é o novo comando de carga?

2. Por que o novo comando de carga é importante?

1. Inicialize a estrutura do projeto

2. Gerencie dependências

3. Melhorar a eficiência do desenvolvimento

6. Variáveis ambientais

7. Status de saída

8Como usar o novo comando cargo?

1. Crie um novo projeto

2. Visualize a estrutura do projeto

3. Compile e execute o projeto

9Estrutura do projeto

10.A importância e utilização de cargas novas no ecossistema Rust

11. Algumas sugestões sobre gestão e manutenção de projetos Rust

12.Conclusão

1.Qual é o novo comando de carga?

cargo new é um dos subcomandos da ferramenta Cargo da linguagem de programação Rust, usada para criar novos projetos Rust. A comunidade Rust dá grande ênfase à organização e manutenção do código, portanto, ao criar um novo projeto, usar o comando cargo new pode ajudar os desenvolvedores a inicializar uma estrutura básica do projeto.

2. Por que o novo comando de carga é importante?

O comando cargo new é muito importante no desenvolvimento do Rust pelos seguintes motivos:

1. Inicialize a estrutura do projeto

Projetos Rust geralmente têm uma estrutura específica de arquivos e diretórios, incluindo um diretório src (para código-fonte), um arquivo Cargo.toml (para definir as dependências e metainformações do projeto), etc. Essas estruturas podem ser facilmente inicializadas usando o comando cargo new sem a necessidade de criar arquivos e diretórios manualmente.

2. Gerencie dependências

A comunidade Rust usa Cargo para gerenciar dependências. Usando o comando cargo new, você pode especificar dependências quando seu projeto for inicializado, para que você possa começar a usar facilmente outras bibliotecas e ferramentas sem editar manualmente o arquivo Cargo.toml.

3. Melhorar a eficiência do desenvolvimento

O comando cargo new pode ajudar os desenvolvedores a iniciar novos projetos rapidamente, economizando tempo na criação de estruturas de projetos e processos de inicialização. Isso permite que os desenvolvedores se concentrem mais em escrever código em vez de configurar o projeto.

3. Gramática básica

A sintaxe básica do comando cargo new é a seguinte:

cargo new [OPTIONS] <PROJECT_NAME>

em:

OPÇÕES: Flags opcionais usados para configurar a criação do projeto.
<PROJECT_NAME>: o nome do projeto a ser criado.

4.Descrição

Este comando criará um novo pacote Cargo no diretório especificado. Isso inclui um modelo simples que contém o manifesto Cargo.toml, arquivos de origem de amostra e um arquivo para ignorar o sistema de controle de versão. Se o diretório ainda não estiver em um repositório do sistema de controle de versão, um novo repositório será criado (veja a opção --vcs abaixo).

Para um comando semelhante que cria um novo manifesto em um diretório existente, consulte comando cargo init .

5.Descrição da opção

Novas opções

--bin: Crie um projeto executável (src/main.rs) (comportamento padrão).
--lib: Crie um projeto de biblioteca (src/lib.rs).
--edition edição: Especifique a versão do Rust a ser usada. O padrão é 2021. Os valores possíveis são: 2015, 2018, 2021.
--name name: Defina o nome do projeto a ser usado. O padrão é o nome do diretório.
--vcs vcs: inicializa um novo repositório de sistema de controle de versão para um determinado sistema de controle de versão (git, hg, pijul ou fossil) ou não inicializa nenhum sistema de controle de versão (nenhum). Se não for especificado, o padrão é git ou o valor de configuração cargo-new.vcs, ou nenhum se já estiver em um repositório do sistema de controle de versão.
--registry Registry: Defina o campo de publicação em Cargo.toml para o nome de registro fornecido, o que limitará a publicação apenas a esse registro. O nome do registro é definido no arquivo de configuração do Cargo . Se não for especificado, o padrão será o registro padrão definido pela chave de configuração Registry.default. Se o registro padrão não estiver definido e --registry não for usado, o campo de publicação não será definido, o que significa que a publicação não será restrita.

Por exemplo, para criar um projeto de biblioteca e especificar a versão Rust 2018, você pode usar o seguinte comando:

cargo new --lib --edition 2018 my_library

Mostrar opções

-v ou --verbose: exibe o processo de criação detalhado.
-q ou --quiet: Não imprime mensagens de log de carga. Também pode ser usado com o valor de configuração term.quiet.
--color quando: Controla quando a saída colorida é usada. Os valores válidos são:
- auto (padrão): detecta automaticamente se o terminal suporta cores.
- sempre: Sempre exibe cores.
- nunca: Nunca exiba a cor. Também pode ser usado com o valor de configuração term.color .

Opções gerais

+toolchain: Se o Cargo foi instalado usando o Rustup, e o primeiro argumento para o cargo começa com +, ele será interpretado como o nome do conjunto de ferramentas do Rustup (por exemplo, +stable ou +nightly). Para obter mais informações sobre a cobertura do conjunto de ferramentas, consulte a documentação do Rustup .
--config KEY=VALUE ou PATH: Substitui os valores de configuração do Cargo. Os parâmetros devem ser fornecidos na sintaxe TOML com KEY=VALUE ou como um caminho para um arquivo de configuração adicional. Este sinalizador pode ser especificado várias vezes. Consulte a seção Substituições de linha de comando para obter mais informações .
-C PATH: Altere o diretório de trabalho atual antes de executar qualquer operação especificada. Isso afeta onde o Cargo procura o manifesto do projeto (Cargo.toml) por padrão, bem como o diretório usado para descobrir .cargo/config.toml, por exemplo. Esta opção deve aparecer antes do nome do comando, como cargo -C path/to/my-project build. Esta opção está disponível apenas no canal noturno e requer que o sinalizador -Z instável-options esteja habilitado (veja #10098 ).
-h ou --help: Imprime informações de ajuda.
-Z flag: Flag instável (somente noturno) para Carga. Execute cargo -Z help para obter detalhes.

6. Variáveis ambientais

Consulte a documentação de referência para obter detalhes sobre as variáveis de ambiente lidas pelo Cargo.

7. Status de saída

0: Carga executada com sucesso.
101: A carga não conseguiu concluir a execução.

8Como usar o novo comando cargo?

Agora vamos ver como criar um novo projeto Rust usando o comando cargo new.

1. Crie um novo projeto

Para criar um novo projeto Rust, basta executar o seguinte comando no terminal:

cargo new my_project

Isto criará um novo projeto chamado “my_project” no diretório atual. Você pode substituir o nome do projeto por qualquer nome que desejar.

2. Visualize a estrutura do projeto

Depois que o projeto for criado com sucesso, você poderá usar o comando ls para visualizar o arquivo do projeto e a estrutura de diretórios. Normalmente, você verá o seguinte:

my_project/
├── Cargo.toml
└── src/
    └── main.rs

O arquivo Cargo.toml é o arquivo de metainformações do projeto e é usado para definir dependências e outras configurações.
O diretório src/ contém o código-fonte Rust do projeto e geralmente inclui um arquivo main.rs como ponto de entrada do projeto.

3. Compile e execute o projeto

Depois que o projeto for criado com sucesso, você poderá usar os seguintes comandos para compilar e executar o projeto:

cd my_project
cargo build  # 构建项目
cargo run    # 运行项目

O comando cargo build compilará o projeto, enquanto o comando cargo run executará o executável compilado.

9Estrutura do projeto

A função principal do comando cargo new é criar uma nova estrutura de projeto, que contém um layout de projeto Rust padrão. Esta estrutura de projeto normalmente inclui o seguinte:

Cargo.toml: metadados do projeto e arquivos de configuração de dependências.
Diretório src: o diretório que contém o código Rust.
src/main.rs ou src/lib.rs: O arquivo de entrada do projeto, dependendo se é um projeto executável ou um projeto de biblioteca.
.gitignore: Lista de arquivos a serem ignorados no controle de versão.
Diretório .git (se você usa Git para controle de versão): Contém arquivos relacionados ao controle de versão do Git.

Dependendo da complexidade e das necessidades do seu projeto, você pode criar mais arquivos de código-fonte Rust no diretório src/ para dividir diferentes módulos e funções. Isso ajuda a manter seu código organizado e de fácil manutenção.

10.A importância e utilização de cargas novas no ecossistema Rust

cargo new é um comando muito importante na linguagem de programação Rust que simplifica o processo de criação de novos projetos. A comunidade Rust enfatiza a facilidade de manutenção e o design modular de projetos, e o comando cargo new ajuda a garantir que novos projetos sigam essas práticas recomendadas. Ao gerar automaticamente uma estrutura de projeto padrão, reduz a complexidade da configuração inicial para que os desenvolvedores possam começar a escrever código mais rapidamente.

Além disso, o arquivo Cargo.toml é o arquivo de configuração principal do projeto Rust, que contém as informações e dependências de metadados do projeto. O projeto criado pelo comando cargo new já contém um arquivo Cargo.toml mínimo, onde você pode adicionar e gerenciar as dependências do projeto, o que é crucial para a utilização de bibliotecas e ferramentas no ecossistema Rust.

11. Algumas sugestões sobre gestão e manutenção de projetos Rust

Depois de criar um projeto Rust usando carga nova, o gerenciamento e a manutenção do projeto tornam-se cruciais. Aqui estão algumas sugestões:

Atualize as dependências regularmente: use o arquivo Cargo.toml para gerenciar as dependências do projeto e execute o comando cargo update regularmente para atualizar as versões das dependências.
Escrevendo testes: Rust incentiva a escrita de testes unitários e de integração para garantir a estabilidade e confiabilidade do projeto.
Use controle de versão: coloque o projeto em um sistema de controle de versão (como Git) para rastrear e gerenciar alterações de código.
Leia a documentação do Rust: A comunidade Rust fornece uma grande variedade de documentação e tutoriais para ajudá-lo a entender e usar melhor o Rust.
Participe da comunidade: A comunidade Rust é muito ativa e participar de discussões da comunidade e contribuir para projetos de código aberto pode ajudá-lo a aprender e crescer.

12.Conclusão

cargo newOs comandos são uma ferramenta importante para a criação de projetos Rust. Ao usar este comando, você pode inicializar rapidamente um novo projeto Rust e começar a escrever código. Compreender a estrutura organizacional de um projeto e como personalizar modelos de projeto pode ajudá-lo a gerenciar e desenvolver melhor projetos Rust. Espero que este artigo ajude você a entender e usar melhor cargo newos comandos. Se você quiser saber mais sobre a linguagem de programação Rust e as ferramentas Cargo, é recomendável verificar a documentação oficial do Rust para obter mais informações.